Skip to main content
POST
/
email-templates
Create an email template
curl --request POST \
  --url https://api.reply.io/v3/email-templates \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Welcome email",
  "subject": "Welcome to our service",
  "body": "<p>Hello {{firstName}},</p><p>Welcome aboard!</p>",
  "folderId": 5,
  "folderType": "personal",
  "attachmentIds": [
    42,
    43
  ]
}
'
{
  "id": 101,
  "name": "Follow-up template",
  "subject": "Quick follow-up",
  "body": "<p>Hi {{firstName}},</p>",
  "folderId": 5,
  "folderType": "personal",
  "attachments": [],
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-02-20T14:00:00Z"
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Body

application/json

Request body for creating a new email template.

name
string
required

Name of the email template

body
string
required

HTML body of the email template

folderType
string
required

Type of the folder (e.g., "personal", "shared")

subject
string | null

Email subject line

folderId
integer | null

ID of the folder to place the template in

attachmentIds
integer[]

List of previously uploaded attachment IDs to associate with the template

Response

Email template created successfully

Full representation of an email template including timestamps.

id
integer
required

Unique identifier for the email template

name
string
required

Name of the email template

body
string
required

HTML body of the email template

createdAt
string<date-time>
required

Timestamp when the template was created

updatedAt
string<date-time>
required

Timestamp when the template was last updated

subject
string | null

Email subject line

folderId
integer | null

ID of the folder containing this template

folderType
string | null

Type of the folder (e.g., "personal", "shared")

attachments
EmailTemplateAttachment · object[]

List of attachments associated with the template