Getting Started
API Reference
Complete reference for all Emailit API v2 endpoints, request formats, and response schemas.
Base URL
All API requests should be made to the following base URL. We support only secure HTTPS requests.
Our current API version is v2 with the following base URL:
Authentication
The Emailit API v2 uses API keys to authenticate requests. You can view and manage your API keys in the Emailit Dashboard.
Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
Rate limits
Our API v2 and SMTP has a starting rate limit of 2 messages per second for new workspaces. You can always request a higher rate limit in Emailit Dashboard.
Each workspace also has a starting rate limit of 5000 messages per day.
Response codes
The API uses conventional HTTP response codes to indicate success or failure.
| Status Code | Description |
|---|---|
| 200 | OK - The request was successful |
| 400 | Bad Request - Invalid request parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 403 | Forbidden - Access denied to requested resource |
| 404 | Not Found - Requested resource does not exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error - Something went wrong on our end |