curl -X POST 'https://api.resend.com/emails' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "from": "Acme <onboarding@resend.dev>",
  "to": [
    "delivered@resend.dev"
  ],
  "subject": "Hello World",
  "html": "<p>It works!</p>"
}'

# POST /emails (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-10-20

> Send an email

Alternatively, template accepts a published template object: id/alias plus variables. It cannot be combined with html or text. See [Resend](https://resend.com/docs/api-reference/emails/send-email).

## Critical 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 accepts either a single recipient email address string or an array of strings for multiple recipients (max 50).

## cURL
curl -X POST 'https://api.resend.com/emails' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"from":"Acme <onboarding@resend.dev>","to":["delivered@resend.dev"],"subject":"Hello World","html":"<p>It works!</p>"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| from | body | string | Yes | Sender email address. To in... |
| to | body | string \| string[] | Yes | Recipient email address. Fo... |
+12 more params

## Response (200 OK)
{"id":"string"}

---
Need an API key? Get one at https://resend.com/signup

POST

POST /emails — Resend API

Resend API

Send an email

Alternatively, template accepts a published template object: id/alias plus variables. It cannot be combined with html or text. See Resend.

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 232 tokens · Vary: Accept

Critical 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 accepts either a single recipient email address string or an array of strings for multiple recipients (max 50).

cURL

curl -X POST 'https://api.resend.com/emails' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "from": "Acme <[email protected]>",  "to": [    "[email protected]"  ],  "subject": "Hello World",  "html": "<p>It works!</p>"}'

Parameters

Name	In	Type	Required	Description
from	body	string	Yes	Sender email address. To include a friendly name, use the format "Your Name <[email protected]>".
to	body	string \| string[]	Yes	Recipient email address. For multiple addresses, send as an array of strings. Max 50.
subject	body	string	Yes	Email subject.
bcc	body	string \| string[]	No	Bcc recipient email address. For multiple addresses, send as an array of strings.
cc	body	string \| string[]	No	Cc recipient email address. For multiple addresses, send as an array of strings.
reply_to	body	string \| string[]	No	Reply-to email address. For multiple addresses, send as an array of strings.
html	body	string	No	The HTML version of the message.
text	body	string	No	The plain text version of the message.
template	body	object	No	Use a published template to send the email. If provided, do not include html or text.
headers	body	object	No	Custom headers to add to the email.
scheduled_at	body	string	No	Schedule email to be sent later. The date should be in ISO 8601 format.
attachments	body	object[]	No	Request body field attachments.
tags	body	object[]	No	Request body field tags.
topic_id	body	string	No	The topic ID to scope the email to. If the recipient is a contact and opted-in to the topic, the email is sent. If opted-out, the email is not sent. If the recipient is not a contact, the email is sent if the topic's default subscription is opt_in.

Response 200 OK

{
  "id": "string"
}

Get a free Resend API key → sponsored

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