Emailwritr API
Integrate AI-powered email writing, subscriber management, and campaign generation directly into your applications and workflows.
Base URL: https://api3.emailwritr.com/api/v1
Authentication
All API requests require an API key. Keys are available on Agency and Enterprise plans. Generate keys from your dashboard.
Pass your key using either method:
Option 1 — X-API-Key header (recommended)
curl -H "X-API-Key: ew_live_your_key_here" \
https://api3.emailwritr.com/api/v1/lists
Option 2 — Authorization Bearer
curl -H "Authorization: Bearer ew_live_your_key_here" \
https://api3.emailwritr.com/api/v1/lists
Keep your key secret. Never expose it in client-side code or public repositories. Each key is shown only once at creation.
Rate Limits
The API allows 100 requests per minute per API key. Exceeding this returns a 429 response.
| Plan | Req / min | API Access |
|---|---|---|
| Premium / Pro / Expert | — | ✗ No |
| Agency / Agency LTD / Agency Lifetime | 100 | ✓ Yes |
| Enterprise / Enterprise LTD / Lifetime | 100 | ✓ Yes |
Lists & Subscribers
GET /api/v1/lists
Return all email lists for the account.
POST /api/v1/lists
Create a new subscriber list.
GET /api/v1/lists/:id
Get a single list by ID.
PUT /api/v1/lists/:id
Update list name or description.
DELETE /api/v1/lists/:id
Delete a list and all its subscribers.
GET /api/v1/lists/:id/subscribers
Get subscribers. Supports status filter and pagination.
POST /api/v1/lists/:id/subscribers
Add a subscriber to a list.
DELETE /api/v1/lists/:id/subscribers/:subscriberId
Remove a subscriber from a list.
Email Writing
POST /api/v1/email/sessions
Create a new AI email writing session.
GET /api/v1/email/sessions
List all email writing sessions.
POST /api/v1/email/sessions/:sessionId/message
Send a prompt to the AI and receive a generated email. Consumes email tokens.
GET /api/v1/email/sessions/:sessionId/conversation
Get the full conversation history for a session.
DELETE /api/v1/email/sessions/:sessionId
Delete an email writing session.
SMS Writing
POST /api/v1/sms/sessions
Create a new AI SMS writing session.
POST /api/v1/sms/sessions/:sessionId/message
Generate an SMS with AI. Consumes SMS tokens.
GET /api/v1/sms/sessions
List all SMS writing sessions.
DELETE /api/v1/sms/sessions/:sessionId
Delete an SMS writing session.
Sequences
GET /api/v1/sequences
List all email sequence requests for the account.
GET /api/v1/sequences/:id
Get a single sequence request and its status.
GET /api/v1/sequences/:id/emails
Get all generated emails within a completed sequence.
Error Responses
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad request — check your parameters |
| 401 | Missing or invalid API key |
| 403 | Plan does not include API access |
| 404 | Resource not found |
| 429 | Rate limit exceeded — 100 req/min |
| 500 | Server error — contact support |
Ready to integrate?
API access is included with Agency and Enterprise plans.