curl -X POST 'https://api.resend.com/templates' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "alias": "string",
  "from": "string",
  "subject": "string",
  "reply_to": [
    "string"
  ],
  "html": "string",
  "text": "string",
  "variables": [
    {
      "key": "string",
      "type": "string",
      "fallback_value": "string"
    }
  ]
}'

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

> Create a template

## 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 is an array of strings, even when sending to a single recipient.

## cURL
curl -X POST 'https://api.resend.com/templates' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","alias":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | The name of the template. |
| html | body | string | Yes | The HTML version of the template. |
| alias | body | string | No | The alias of the template. |

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

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

POST

/templates

Resend API

Create a template

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

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 210 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 is an array of strings, even when sending to a single recipient.

cURL

curl -X POST 'https://api.resend.com/templates' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "alias": "string",  "from": "string",  "subject": "string",  "reply_to": [    "string"  ],  "html": "string",  "text": "string",  "variables": [    {      "key": "string",      "type": "string",      "fallback_value": "string"    }  ]}'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	The name of the template.
alias	body	string	No	The alias of the template.
from	body	string	No	Sender email address. To include a friendly name, use the format "Your Name <sender@domain.com>".
subject	body	string	No	Email subject.
reply_to	body	string[]	No	Reply-to email addresses.
html	body	string	Yes	The HTML version of the template.
text	body	string	No	The plain text version of the template.
variables	body	object[]	No	Request body field variables.

Response 200 OK

{
  "id": "string",
  "object": "template"
}