mailer123
API reference

Domains

View a project's sending domains (read-only).

View your sending domains and their verification status. These endpoints are read-only — domains are added, verified, and removed from the dashboard, not the API.

List domains

GET/v1/projects/{id}/domainsfull access

Returns every sending domain in the project with its verification status (DKIM, MAIL FROM, DMARC), region, and creation time.

bash
curl https://mailer123.com/api/v1/projects/PROJECT_ID/domains \
-H "Authorization: Bearer m123_your_api_key"
json
{ "data": [ { "domain": "mail.example.com", "verifiedForSending": true, "dkim": "verified", "mailFrom": "verified", "dmarc": "verified", "region": "us-east-1", "createdAt": "..." } ] }

Retrieve a domain

GET/v1/projects/{id}/domains/{domain}full access

Returns one domain by name with its DNS records, full verification detail, the detected DNS provider, lifecycle events, and any open AWS SES deliverability recommendations. Responds 404 not_found if the domain isn't in this project.

bash
curl https://mailer123.com/api/v1/projects/PROJECT_ID/domains/mail.example.com \
-H "Authorization: Bearer m123_your_api_key"
json
{ "data": { "domain": "mail.example.com", "verifiedForSending": true, "verification": "verified", "dkim": "verified", "mailFrom": "verified", "dmarc": "verified", "records": [ { "purpose": "DKIM", "type": "CNAME", "name": "...", "value": "..." } ], "recommendations": [] } }

Managing domains

Adding a domain, publishing DNS, and deleting are dashboard-only actions — the API exposes no write endpoints for domains. Add and verify a domain under Domains in the dashboard, then send from a verified address.

Errors

insufficient_scope (403 — sending-only key), forbidden (403 — key not authorized for that project), not_found (404). See the error reference.

PreviousTemplates