Reference
API Reference
Every endpoint at a glance. All endpoints are prefixed with https://api.eusend.dev.
All endpoints are prefixed with https://api.eusend.dev. All authenticated
endpoints require Authorization: Bearer <key>.
| Method | Endpoint | Description |
|---|
POST | /emails | Send a single email (schedule with scheduled_at) |
POST | /emails/batch | Send up to 100 emails |
GET | /emails | List emails |
GET | /emails/:id | Get email + event history |
PATCH | /emails/:id | Reschedule a scheduled email |
POST | /emails/:id/cancel | Cancel a scheduled email |
| Method | Endpoint | Description |
|---|
POST | /templates | Create a template |
GET | /templates | List templates |
GET | /templates/:id | Get a template |
GET | /templates/:id/preview | Render a preview with variables |
PATCH | /templates/:id | Update a template |
DELETE | /templates/:id | Delete a template |
| Method | Endpoint | Description |
|---|
POST | /broadcasts | Create a broadcast (draft) |
GET | /broadcasts | List broadcasts |
GET | /broadcasts/:id | Get broadcast |
PATCH | /broadcasts/:id | Update draft / schedule broadcast |
POST | /broadcasts/:id/send | Send, schedule, or resume broadcast |
POST | /broadcasts/:id/cancel | Cancel scheduled or in-flight broadcast |
DELETE | /broadcasts/:id | Delete a draft or cancelled broadcast |
| Method | Endpoint | Description |
|---|
POST | /audiences | Create an audience |
GET | /audiences | List audiences |
DELETE | /audiences/:id | Delete an audience |
POST | /audiences/:id/contacts | Add / upsert a contact |
POST | /audiences/:id/contacts/batch | Batch upsert up to 1,000 contacts |
GET | /audiences/:id/contacts | List contacts |
GET | /audiences/:id/contacts/:contactId | Get a contact |
PATCH | /audiences/:id/contacts/:contactId | Update contact (name, subscription) |
DELETE | /audiences/:id/contacts/:contactId | Remove a contact |
| Method | Endpoint | Description |
|---|
POST | /domains | Register a domain |
GET | /domains | List domains |
GET | /domains/:id | Get domain details |
DELETE | /domains/:id | Delete domain |
POST | /domains/:id/verify | Trigger DKIM verification |
| Method | Endpoint | Description |
|---|
POST | /api-keys | Create an API key |
GET | /api-keys | List API keys |
DELETE | /api-keys/:id | Revoke an API key |
| Method | Endpoint | Description |
|---|
POST | /webhooks | Create a webhook |
GET | /webhooks | List webhooks |
GET | /webhooks/:id | Get webhook + recent deliveries |
PATCH | /webhooks/:id | Update a webhook |
DELETE | /webhooks/:id | Delete a webhook |
| Method | Endpoint | Description |
|---|
GET | /health | Health check (no auth) |