EMAIL API
Send email from
your application.
Connect a sending domain, create an API key, and track delivery in one place.
Sign in
Overview
Usage and recent activity.
Recent messages
Quotes
Share a quote and keep track of the customer's response.
Domains
Verify the domains you want to send from.
API keys
Create a separate key for each integration.
Save your API key
Copy the full key now. You will only see it once.
Plans
Daily and monthly limits reset in UTC.
API documentation
Send from a verified domain and check message status.
POST /v1/emails
Provide from, to, subject, and at least one of text or html. Reuse the same Idempotency-Key when retrying a request.
A 202 response returns the message ID and queue status.
GET /v1/emails/{id}
Use the same Authorization header. relayed means the local mail server accepted the message. Test mode returns simulated.
POST /v3/mail/send
This endpoint accepts a subset of the SendGrid format for a single recipient. Use from.email, personalizations[0].to[0].email, subject, and content with text or HTML. The message ID is in the X-Message-Id header.
GET /v1/events?after=0
Fetch events and reuse the returned after cursor in the next request. delivered means the recipient's mail server accepted the message.
For attachments, provide filename, MIME type, and Base64 content in the attachments array. The limit is five files and 4 MiB total.
Event webhook
Receive signed events over HTTPS on a verified domain or one of its subdomains.
Administration
Customers, plans, and sending status.