Quickstart

From a new account to your first delivered email in four steps.

1
Turn on the Developer API
Sign in at developers.iresendly.com with your iResendly account and choose Activate Developer API. It's free, with no card.
2
Verify your domain
Under Domains, add the domain you'll send from and publish its three DNS records. Domains you already verified for Marketing or Business Email are imported as verified. See Domains.
3
Create an API key
Under API Keys, create a key. It's shown once: store it in your server's environment, for example IRESENDLY_API_KEY.
4
Send an email
Call POST /emails from your server:

POST /emails

curl -X POST 'https://api.iresendly.com/emails' \
  -H 'Authorization: Bearer irs_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["jane@example.com"],
    "subject": "Hello from iResendly",
    "html": "<strong>It works!</strong>"
  }'

A 200 response with an id means the email is accepted. Follow it under Emails in the console, or get its email.delivered event with a webhook.

Tip

Add an Idempotency-Key header to every send. If a request times out and you retry, the email still goes out only once. See Idempotency.

Still stuck? Write to us and we'll reply by email.Contact us support@iresendly.com