MailDiver email service APIs allow you to send transactional emails, manage domains, and handle audience and contacts programmatically. The APIs for the managed and self-hosted versions are the same. The only difference is the base URL, which is where you use your own domain for the self-hosted version.

​
Getting Started

To start using the email service APIs:
  1. Create an API key from the dashboard
  2. Use your API key in the Authorization header for all requests:
Authorization: Bearer <your-api-key>

​
Base URL

All API endpoints are prefixed with api. subdomain:
The base URL is https://api.maildiver.com

​
API Versioning

The current version of the API is v1. All endpoints are prefixed with /v1/: 
https://api.maildiver.com/v1/emails

​
Error Handling

The API uses standard HTTP status codes and returns error messages in a consistent format: 
{
  "message": "Error description",
  "code": "error_code" // Only included for authentication errors
}
Common status codes:
  • 200: Success
  • 201: Created
  • 204: No Content
  • 400: Bad Request
  • 403: Forbidden
  • 404: Not Found
  • 429: Too Many Requests

​
Support

Need help? We’re here for you: