mailer123
Getting started

Quickstart

Send your first email with the API in a couple of minutes.

1. Create an API key

In your dashboard, go to Settings → API and create a key. Choose Full access if you'll also manage contacts and campaigns, or Sending only if you just need to send email. Copy the key now — it's shown only once.

2. Verify a sending domain

Under Domains, verify the domain you'll send from (for example yourdomain.com) by adding the DNS records we show you. You can then send from any address on that domain.

3. Send an email

Make a POST request to /v1/emails with your key in the Authorization header:

bash
curl -X POST https://mailer123.com/api/v1/emails \
-H "Authorization: Bearer m123_your_api_key" \
-H "Content-Type: application/json" \
-d '{
  "from": "you@yourdomain.com",
  "to": "customer@example.com",
  "subject": "Welcome aboard",
  "html": "<h1>Hi {{name|there}}</h1><p>Thanks for signing up.</p>"
}'

A successful call returns the message id:

json
HTTP/1.1 202 Accepted

{ "id": "0100018f-1a2b-3c4d-..." }

That's it. Next, read Authentication to learn about scopes and key security, or see the full Emails endpoint reference.

PreviousIntroductionNextAuthentication