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
Links
- GitHub: notifycx/notifycx (SDK + MCP source)
- npm: notifycx
- Runnable examples
- Quick start
- MCP for coding agents