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 request401 Unauthorized
: Invalid or missing API key429 Too Many Requests
: Rate limit exceeded500 Server Error
: Internal server error, contact support
FAQ
Why are my emails not being delivered?
- Check your email logs in the dashboard
- Verify recipient email addresses
- Ensure your domain is verified for better deliverability
- 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?
- Verify your domain at notify.cx/dashboard/domains
- Monitor your usage through analytics
- Contact support for temporary limit increases
How do I debug template issues?
- Preview templates in the template builder
- Check all required variables are provided
- Verify template ID is correct
- Test with minimal variables first
Support Resources
Documentation
Getting Help
- Email: hello@notify.cx
- Dashboard: notify.cx/dashboard
- Status Page: status.notify.cx