EmailMarketer.io has an HTTP API for everything you do in the app: contacts, lists, segments, campaigns, journeys, sender domains and transactional email. This page shows the two kinds of API key, the request format, and your first calls.
Two ways in
| You want to | Use | Key |
|---|---|---|
| Send one transactional email from your app | POST /api/v1/email or SMTP |
Sender API key of a sending domain |
| Manage contacts, lists, campaigns and journeys | Account API commands | Account API key |
Both run on https://app.emailmarketer.io. Authentication explains where to create each key.
The examples in these docs read the account API key from the EM_API_KEY environment variable and the sender API key from EM_SENDER_KEY. Set them before you run an example, for example export EM_API_KEY=your-key.
Request format
Account API commands are named like subscriber.create. Send the command name in Command and your key in APIKey, as form fields or as a JSON body:
curl https://app.emailmarketer.io/api.php \
-d Command=lists.get \
-d APIKey="$EM_API_KEY"
Many commands also have their own path under /api/v1/. The same call to /api/v1/lists.get works the same way. Each reference page shows the path when one exists. When a command has no path of its own, use /api.php.
Responses are JSON. A successful legacy command looks like this:
{ "Success": true, "ErrorCode": 0, "ErrorText": "", "Lists": [ ... ] }
Errors and status codes covers the error formats.
Quickstart: add a contact
- Create an account API key in the app.
- Find the ID of a list with
lists.get(above). - Add a contact:
curl https://app.emailmarketer.io/api.php \
-d Command=subscriber.create \
-d APIKey="$EM_API_KEY" \
-d ListID=123 \
-d EmailAddress=jane@example.com \
-d SubscriptionDate="2026-11-17 09:30:00" \
-d SubscriptionIP=203.0.113.10
The response carries the new contact’s ID:
{ "Success": true, "ErrorCode": 0, "SubscriberInformation": { "SubscriberID": 456, "EmailAddress": "jane@example.com", "SubscriptionStatus": "Subscribed" } }
Quickstart: send a transactional email
- Verify a sending domain in the app.
- Create a sender API key for that domain under Transactional, on the domain’s API keys tab.
- Send:
curl -X POST https://app.emailmarketer.io/api/v1/email \
-H "Authorization: Bearer $EM_SENDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"From": { "name": "Acme", "email": "no-reply@acme.com" },
"To": [{ "name": "Jane", "email": "jane@example.com" }],
"Subject": "Reset your password",
"ContentType": "html",
"HTMLContent": "<p>Click the link to reset your password.</p>"
}'
{ "MessageID": "550e8400-e29b-41d4-a716-446655440000" }
Send email lists every field.
Where to go next
- Webhooks: get delivery, bounce, open, click and unsubscribe events for transactional email.
- AI assistants (MCP): connect Claude, ChatGPT and other assistants to your account.
- The API reference in the menu: one page per area, with every parameter and error code.