POST
/
v3
/
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

Maximum string length: 255
body
string
required

HTML body of the email template

folderType
enum<string>
required

Type of the folder

Available options:
personal,
team
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

Maximum array length: 3

Response

Email template created successfully

Full representation of an email template including timestamps.

id
integer

Unique identifier for the email template

name
string

Name of the email template

subject
string | null

Email subject line

body
string

HTML body of the email template

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

createdAt
string<date-time>

Timestamp when the template was created

updatedAt
string<date-time>

Timestamp when the template was last updated