Official notifycx SDK

Install notifycx — typed Node/TypeScript client for Notify transactional email.

The official SDK for Node and TypeScript. Prefer this in app code; use plain fetch in other languages, or notifycx-mcp in IDE coding agents.

Pro is $10 for 10,000 emails. Domain auth (SPF/DKIM/DMARC), logs, and webhooks included.

Install

npm install notifycx

Send

import Notify from 'notifycx'

const notify = new Notify({ apiKey: process.env.NOTIFY_API_KEY! })
// or: new Notify(process.env.NOTIFY_API_KEY!)

await notify.send({
  to: 'user@example.com',
  from: 'Acme <hello@yourdomain.com>',
  subject: 'Reset your password',
  html: '<p>Click to reset…</p>',
})

Accepts html, message, or text (first non-empty wins). Prefer html so Resend-shaped pastes work.

Sandbox

await notify.sendTest({
  to: 'you@example.com',
  from: 'hello@yourdomain.com',
  subject: 'API rehearsal',
  html: '<p>Does not deliver</p>',
})

Domains, webhooks, usage

Same client — add a domain, poll verification, wire webhooks, check quota:

await notify.addDomain({ domain: 'yourdomain.com' })
await notify.checkDomain('yourdomain.com')
await notify.listDomains()
await notify.getDomain('yourdomain.com')

await notify.createWebhook({
  webhookUrl: 'https://example.com/hooks/notify',
  subscribedEvents: ['Delivery', 'Bounce'],
  domainId: '…', // from listDomains
})
await notify.listWebhooks()
await notify.testWebhook({
  webhookUrl: 'https://example.com/hooks/notify',
  eventType: 'Delivery',
})

await notify.getUsage()
await notify.listApiKeys() // prefix only — never the full secret
await notify.listLogs({ limit: 20 })

API keys: use a full_access key for MCP / management. App sends can use a sending_access key locked to one verified domain (Credentials in the dashboard).

Errors

Failed requests throw NotifyError with status and body (e.g. missing key, unverified domain, sandbox lock).

Next.js

See Send email in Next.js.

Links