Email API for sending and verification
One REST API for transactional email, email verification, contacts, campaigns, domains, webhooks, reports and usage — with scoped keys, per-plan rate limits and request logs.
| Resource | Endpoints | Scope |
|---|---|---|
| Send | POST /send · GET /messages · GET /messages/{id} | send |
| Verify | POST /verify (single or bulk) · GET /verify/{id} | verify |
| Contacts & lists | GET/POST /contacts · GET/DELETE /contacts/{id} · GET/POST /lists | contacts |
| Campaigns | GET/POST /campaigns · GET /campaigns/{id} · POST /campaigns/{id}/send | campaigns |
| Domains | GET/POST /domains · GET /domains/{id} · POST /domains/{id}/verify | domains |
| Webhooks | GET/POST /webhooks · PATCH/DELETE /webhooks/{id} · POST /webhooks/{id}/test · GET /webhooks/{id}/deliveries | webhooks |
| Automations | GET /automations · POST /automations/{id}/trigger · GET /automations/runs/{id} | automations |
| AI | POST /ai/campaign · GET /ai/requests/{id} | ai |
| Reports & usage | GET /reports/overview · GET /reports/campaigns/{id} · GET /usage · GET /credits | reports |
| Account | GET /me | any key |
Scoped API keys
Limit each key to what it needs; rotate or revoke at any time. Secrets are shown once.
Signed webhooks
HMAC-SHA256 signatures, retries with back-off and a delivery log for every event.
Usage & logs
Request log with status, latency and request IDs; usage endpoints for your own dashboards.
Send your first email in one request
Use the API key from your dashboard and a From address on your verified domain.
curl -X POST https://smtp.inboxroads.com/api/v1/send \
-H "Authorization: Bearer $INBOXROADS_KEY" \
-H "Content-Type: application/json" \
-d '{"from": "Shop <orders@shop.com>",
"to": ["jane@example.com"],
"subject": "Your order is confirmed",
"html": "<p>Thanks for your order!</p>"}'
curl -X POST https://smtp.inboxroads.com/api/v1/verify \
-H "Authorization: Bearer $INBOXROADS_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "jane@example.com"}'
More examples for PHP, Laravel, Node.js, Python and n8n are in the API documentation. Prefer SMTP? Use the SMTP relay instead.
Email API FAQ
Send transactional email, verify email addresses one at a time or in bulk, manage contacts and lists, create and send campaigns, add and verify sending domains, manage webhooks, trigger automations and read reports and credit usage — everything the dashboard does.
Create an API key in your dashboard under Developers and send it as a Bearer token in the Authorization header. Each key can be limited to the scopes it needs, and you can rotate or revoke keys at any time.
Yes. POST /api/v1/verify checks a single address in real time or creates a bulk job for many addresses. Each verification uses one credit, the same as in the dashboard.
Yes, per API key, depending on your plan. Responses include rate-limit headers, and a 429 response tells you how long to wait before retrying.
Register a webhook endpoint. InboxRoads sends delivered, bounced, complained, opened, clicked and other events, signed with HMAC-SHA256, and retries failed deliveries with back-off.
Yes, through the HTTP request steps those tools provide, using your API key — plus webhooks and automation triggers for the other direction. The developer docs include an n8n example.
Get your API key
Create a free account, verify your domain and start sending or verifying from your own code.