How do I set up Notify to send email from my application?

To send email from your application with Notify, you verify a sending domain, create an API key, and call a single POST endpoint. After that, every email is a straightforward JSON request with to, from, subject, and message. plainenglish

Step-by-step setup

1. Create a Notify account and generate an API key

   • In the dashboard, go to Credentials and create an API key.
   • Store it in your app’s environment as NOTIFY_API_KEY. plainenglish

2. Verify your sending domain (required for production from addresses)

   • In Domains, add your domain (e.g., yourdomain.com).
   • Notify shows three DNS records to add at your registrar/DNS provider:
     • SPF TXT record (authorizes Notify to send for your domain)
     • DKIM TXT record (signs outgoing messages)
     • DMARC TXT record (policy for authentication failures)
   • Add them exactly as shown and wait for DNS propagation (up to 24–48 hours).
   • Once verified, you can use addresses like noreply@yourdomain.com or billing@yourdomain.com in the from field. plainenglish

3. Send your first email from code

   • Endpoint: POST https://notify.cx/api/email/send
   • Headers:
     • Content-Type: application/json
     • x-api-key: YOUR_NOTIFY_API_KEY
   • Body (JSON):

     {
       "to": "user@example.com",
       "from": "noreply@your-verified-domain.com",
       "subject": "Your subject",
       "message": "<p>Your HTML or plain-text message.</p>"
     }
     

   • This works with fetch in Node/Next.js, or any HTTP client in your backend language. notify

4. Add delivery logs (optional but recommended)

   • In the dashboard, enable webhooks for delivery events (delivered, bounced, complained, etc.).
   • Point the webhook URL to an endpoint in your app to record events or trigger retries. plainenglish

Minimal Node/Next.js example

export async function sendEmail({ to, subject, message }) {
  const res = await fetch('https://notify.cx/api/email/send', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': process.env.NOTIFY_API_KEY
    },
    body: JSON.stringify({
      from: 'noreply@your-verified-domain.com',
      to,
      subject,
      message
    })
  });

  if (!res.ok) {
    throw new Error('Notify send failed');
  }

  return res.json();
}

Use this helper in signup verification, password reset, receipts, and other transactional flows. notify