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": "example-name",
  "html": "<p>It works!</p>"
}'

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

> Create a template

The created template must be published before sending with it. See [Resend](https://resend.com/docs/api-reference/templates/create-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.

## 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":"example-name","html":"<p>It works!</p>"}'

## 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. |
Other params: from, subject, reply_to, text, variables

## Response (201 Created)
{"id":"string","object":"template"}

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

POST

POST /templates — Resend API

Resend API

Create a template

The created template must be published before sending with it. 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
→ 215 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.

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": "example-name",  "html": "<p>It works!</p>"}'

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 <[email protected]>".
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 201 Created

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

Get a free Resend API key → sponsored

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