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.