Email
Resend API Reference
Transactional email API. Send, schedule and track emails; manage sending domains, API keys, audiences and contacts.
109 Endpoints
17 Resources
Verified 2026-09-03
Auth
Authorization: Bearer <RESEND_API_KEY> Gotchas All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.
The to field is an array of strings, even when sending to a single recipient.
Agents
curl -H "Accept: text/markdown" https://apicheats.dev/resend/llms.txt Emails
10 endpoints GET /emails Retrieve a list of emails .md POST /emails Send an email .md GET /emails/{email_id} Retrieve a single email .md PATCH /emails/{email_id} Update a single email .md POST /emails/{email_id}/cancel Cancel the schedule of the e-mail. .md POST /emails/{email_id}/share Create a shareable link for a sent or received email. .md POST /emails/batch Trigger up to 100 batch emails at once. .md GET /emails/{email_id}/attachments Retrieve a list of attachments for a sent email .md GET /emails/{email_id}/attachments/{attachment_id} Retrieve a single attachment for a sent email .md GET /emails/metrics Retrieve account-level email metrics .md
Receiving Emails
4 endpoints GET /emails/receiving Retrieve a list of received emails .md GET /emails/receiving/{email_id} Retrieve a single received email .md GET /emails/receiving/{email_id}/attachments Retrieve a list of attachments for a received email .md GET /emails/receiving/{email_id}/attachments/{attachment_id} Retrieve a single attachment for a received email .md
Domains
9 endpoints GET /domains Retrieve a list of domains .md POST /domains Create a new domain .md GET /domains/{domain_id} Retrieve a single domain .md DELETE /domains/{domain_id} Remove an existing domain .md PATCH /domains/{domain_id} Update an existing domain .md POST /domains/{domain_id}/verify Verify an existing domain .md POST /domains/claim Claim a domain .md GET /domains/{domain_id}/claim Retrieve a domain claim .md POST /domains/{domain_id}/claim/verify Verify a domain claim .md
API Keys
4 endpointsOAuth
2 endpointsTemplates
7 endpoints GET /templates Retrieve a list of templates .md POST /templates Create a template .md GET /templates/{id} Retrieve a single template .md DELETE /templates/{id} Remove an existing template .md PATCH /templates/{id} Update an existing template .md POST /templates/{id}/publish Publish a template .md POST /templates/{id}/duplicate Duplicate a template .md
Audiences
4 endpointsContacts
13 endpoints GET /contacts Retrieve a list of contacts .md POST /contacts Create a new contact .md GET /contacts/imports Retrieve a list of contact imports .md POST /contacts/imports Create a contact import .md GET /contacts/imports/{id} Retrieve a single contact import .md GET /contacts/{id} Retrieve a single contact by ID or email .md DELETE /contacts/{id} Remove an existing contact by ID or email .md PATCH /contacts/{id} Update a single contact by ID or email .md GET /contacts/{contact_id}/segments Retrieve a list of segments for a contact .md POST /contacts/{contact_id}/segments/{segment_id} Add a contact to a segment .md DELETE /contacts/{contact_id}/segments/{segment_id} Remove a contact from a segment .md GET /contacts/{contact_id}/topics Retrieve topics for a contact .md PATCH /contacts/{contact_id}/topics Update topics for a contact .md
Broadcasts
9 endpoints GET /broadcasts Retrieve a list of broadcasts .md POST /broadcasts Create a broadcast .md GET /broadcasts/{id} Retrieve a single broadcast .md DELETE /broadcasts/{id} Remove an existing broadcast that is in the draft status .md PATCH /broadcasts/{id} Update an existing broadcast .md POST /broadcasts/{id}/send Send or schedule a broadcast .md POST /broadcasts/{id}/cancel Cancel a broadcast .md GET /broadcasts/{id}/recipients Retrieve broadcast recipients .md GET /broadcasts/{id}/clicked-links Retrieve a broadcast's clicked links .md
Webhooks
9 endpoints GET /webhooks Retrieve a list of webhooks .md POST /webhooks Create a new webhook .md GET /webhooks/{webhook_id} Retrieve a single webhook .md DELETE /webhooks/{webhook_id} Remove an existing webhook .md PATCH /webhooks/{webhook_id} Update an existing webhook .md GET /webhooks/{webhook_id}/events Retrieve a list of webhook events .md GET /webhooks/{webhook_id}/events/{event_id} Retrieve a single webhook event .md POST /webhooks/{webhook_id}/events/{event_id}/replay Replay a webhook event .md GET /webhooks/{webhook_id}/events/{event_id}/attempts Retrieve a list of webhook event attempts .md
Segments
5 endpointsTopics
5 endpointsContact Properties
5 endpoints GET /contact-properties Retrieve a list of contact properties .md POST /contact-properties Create a new contact property .md GET /contact-properties/{id} Retrieve a single contact property .md DELETE /contact-properties/{id} Remove an existing contact property .md PATCH /contact-properties/{id} Update an existing contact property .md
Logs
2 endpointsAutomations
9 endpoints GET /automations Retrieve a list of automations .md POST /automations Create an automation .md GET /automations/{automation_id} Retrieve a single automation .md DELETE /automations/{automation_id} Delete an automation .md PATCH /automations/{automation_id} Update an automation .md POST /automations/{automation_id}/duplicate Duplicate an automation .md POST /automations/{automation_id}/stop Stop an automation .md GET /automations/{automation_id}/runs Retrieve a list of automation runs .md GET /automations/{automation_id}/runs/{run_id} Retrieve a single automation run .md
Events
6 endpointsSuppressions
6 endpoints GET /suppressions Retrieve a list of suppressions .md POST /suppressions Create a suppression .md POST /suppressions/batch/add Add up to 100 suppressions at once .md POST /suppressions/batch/remove Remove up to 100 suppressions at once .md GET /suppressions/{suppression} Retrieve a single suppression by ID or email .md DELETE /suppressions/{suppression} Remove a single suppression by ID or email .md
No Resend endpoint matches
Source: raw.githubusercontent.com/resend/resend-openapi/main/resend.yaml · sha256 4e3a…05ec · checked daily 04:00 UTC All providers →