Skip to content

SendGrailTransactional email API

Send email from your own domain with one HTTP request. DKIM signing, delivery events and webhooks included.

What is SendGrail? ​

SendGrail is a transactional email API. Your application calls a single endpoint to send email — receipts, password resets, notifications — and SendGrail handles delivery through AWS SES, DKIM signing, bounce and complaint tracking, and webhook fan-out.

These docs are for developers integrating SendGrail. If you can make an HTTPS request, you can send email in a few minutes.

How it works ​

Your app ──POST /v1/emails──▶ SendGrail ──▶ AWS SES ──▶ Recipient
                              │
                              └──webhook──▶ Your app   (delivered, bounced, …)
  1. You send a message with a single authenticated POST request.
  2. SendGrail validates it, queues it, and hands it to AWS SES for delivery.
  3. As SES reports back, the message status updates and SendGrail posts a signed event to any webhook you've registered.

Before you can send ​

Sending requires two things, both set up once in the dashboard:

  • A verified domain — the domain in your from address. See Domains & verification.
  • An API key — the bearer token your app authenticates with. See API keys.

The Quickstart walks through both, then sends your first message.

Find your way around ​

If you want to…Go to
Send your first email end to endQuickstart
Look up the send endpoint and its fieldsSend an email
Receive delivery events in your appWebhooks
Understand error responsesErrors & rate limits
Manage domains, keys and sending healthThe dashboard

Getting help ​

If something doesn't behave as documented, reach out to support@sendgrail.com.

Transactional email on your own domain.