142 of 142

resend/llms.txt

Email

Resend API Reference

Transactional email API. Send, schedule and track emails; manage sending domains, API keys, audiences and contacts.

142 Endpoints

19 Resources

Verified 2026-10-20

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.

Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.

Agents curl -H "Accept: text/markdown" https://apicheats.dev/resend/llms.txt

curl -H "Accept: text/markdown" https://apicheats.dev/resend/llms.txt

Choose your task

Send one email

Send a single email.

Send an email
Send multiple emails in one batch

Send multiple emails in a single request.

Send a batch
Verify a sending domain

Verify an existing domain.

Verify a domain
Create and manage a template lifecycle

Create, retrieve, update and publish a template.

Create a template Retrieve a template Update a template Publish a template
Inspect a sent email

Retrieve a single email by its ID.

Retrieve an email

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 endpoints

GET /api-keys Retrieve a list of API keys .md

POST /api-keys Create a new API key .md

DELETE /api-keys/{api_key_id} Remove an existing API key .md

PATCH /api-keys/{api_key_id} Update an existing API key .md

OAuth

2 endpoints

GET /oauth/grants Retrieve a list of OAuth grants .md

DELETE /oauth/grants/{oauth_grant_id} Revoke an OAuth grant .md

Templates

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 endpoints

GET /audiences Retrieve a list of audiences .md

POST /audiences Create a list of contacts .md

GET /audiences/{id} Retrieve a single audience .md

DELETE /audiences/{id} Remove an existing audience .md

Contacts

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

Segments

6 endpoints

GET /segments Retrieve a list of segments .md

POST /segments Create a new segment .md

GET /segments/{id} Retrieve a single segment .md

DELETE /segments/{id} Remove an existing segment .md

PATCH /segments/{id} Update an existing segment .md

GET /segments/{id}/contacts Retrieve a list of contacts in a segment .md

Topics

5 endpoints

GET /topics Retrieve a list of topics .md

POST /topics Create a new topic .md

GET /topics/{id} Retrieve a single topic .md

DELETE /topics/{id} Remove an existing topic .md

PATCH /topics/{id} Update an existing topic .md

Contact 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 endpoints

GET /logs Retrieve a list of logs .md

GET /logs/{log_id} Retrieve a single log .md

Automations

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 endpoints

GET /events Retrieve a list of events .md

POST /events Create an event .md

POST /events/send Send an event .md

GET /events/{identifier} Retrieve a single event .md

DELETE /events/{identifier} Delete an event .md

PATCH /events/{identifier} Update an event .md

Suppressions

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

Usage

1 endpoint

GET /usage Retrieve account usage .md

Inboxes

29 endpoints

GET /inboxes Retrieve a list of inboxes .md

POST /inboxes Create an inbox .md

GET /inboxes/{inbox_id} Retrieve a single inbox by ID or email address .md

DELETE /inboxes/{inbox_id} Remove an existing inbox by ID or email address .md

PATCH /inboxes/{inbox_id} Update an existing inbox by ID or email address .md

GET /inboxes/{inbox_id}/agent Retrieve the agent settings for an inbox .md

PATCH /inboxes/{inbox_id}/agent Update the agent settings for an inbox .md

GET /inboxes/{inbox_id}/labels Retrieve a list of inbox labels .md

POST /inboxes/{inbox_id}/labels Create a label on an inbox .md

DELETE /inboxes/{inbox_id}/labels/{label_id} Remove an existing inbox label .md

PATCH /inboxes/{inbox_id}/labels/{label_id} Update an existing inbox label .md

GET /inboxes/{inbox_id}/threads Retrieve a list of inbox threads .md

GET /inboxes/{inbox_id}/threads/search Search the threads of an inbox .md

GET /inboxes/{inbox_id}/threads/{thread_id} Retrieve a single inbox thread .md

DELETE /inboxes/{inbox_id}/threads/{thread_id} Remove an existing inbox thread .md

PATCH /inboxes/{inbox_id}/threads/{thread_id} Update an existing inbox thread .md

POST /inboxes/{inbox_id}/threads/{thread_id}/labels Add labels to an inbox thread .md

PUT /inboxes/{inbox_id}/threads/{thread_id}/labels Set the labels of an inbox thread .md

DELETE /inboxes/{inbox_id}/threads/{thread_id}/labels/{label_id} Remove a label from an inbox thread .md

GET /inboxes/{inbox_id}/threads/{thread_id}/emails Retrieve a list of thread emails .md

GET /inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id} Retrieve a single thread email .md

POST /inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/reply Reply to a thread email .md

POST /inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/forward Forward a thread email .md

GET /inboxes/{inbox_id}/drafts Retrieve a list of drafts .md

POST /inboxes/{inbox_id}/drafts Create a draft .md

GET /inboxes/{inbox_id}/drafts/{draft_id} Retrieve a single draft .md

DELETE /inboxes/{inbox_id}/drafts/{draft_id} Remove an existing draft .md

PATCH /inboxes/{inbox_id}/drafts/{draft_id} Update an existing draft .md

POST /inboxes/{inbox_id}/drafts/{draft_id}/send Send a draft .md

Source: raw.githubusercontent.com/resend/resend-openapi/main/resend.yaml · sha256 4e77…500f · checked daily 04:00 UTC All providers →