Troubleshooting

Common Issues

API Key Issues

  • Invalid API Key: Ensure your API key is correctly set in your environment variables
  • Exposed API Key: If you've accidentally exposed your key, regenerate it immediately from the dashboard
  • Missing API Key: The SDK will throw an error if initialized without an API key

Rate Limiting

  • Trial Account Limits: You've hit the 100 email total or 10/hour limit
  • Hourly Quota Exceeded: Wait for the next hour window or verify your domain for higher limits

Email Delivery

  • Bounced Emails: Verify recipient email addresses are correct
  • Failed Deliveries: Check domain verification status
  • Template Variables: Ensure all required template variables are provided

Error Messages

SDK Errors

// Missing API Key
const notify = new Notify(); // Error: API key is required
// Invalid Template Variables
await notify.sendEmailFromTemplate({
  templateId: 'template_id'
  // Error: Missing required template variables
});

API Response Errors

  • 400 Bad Request: Invalid parameters in your request
  • 401 Unauthorized: Invalid or missing API key
  • 429 Too Many Requests: Rate limit exceeded
  • 500 Server Error: Internal server error, contact support

FAQ

Why are my emails not being delivered?

  1. Check your email logs in the dashboard
  2. Verify recipient email addresses
  3. Ensure your domain is verified for better deliverability
  4. Check your rate limits

How do I track email status?

Access the email logs dashboard at notify.cx/dashboard/logs to view:

  • Delivery status
  • Sending timestamps
  • Error messages
  • Event tracking

What should I do if I hit rate limits?

  1. Verify your domain at notify.cx/dashboard/domains
  2. Monitor your usage through analytics
  3. Contact support for temporary limit increases

How do I debug template issues?

  1. Preview templates in the template builder
  2. Check all required variables are provided
  3. Verify template ID is correct
  4. Test with minimal variables first

Support Resources

Documentation

Getting Help

Implementation Examples