Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Email Templates

Create an email template

<small>Requires the sequences:write scope (or a broader one that includes it).</small>

Creates a new email template.

post/v3/email-templates

Request body

namestring required

Name of the email template

subjectstring nullable

Email subject line

bodystring required

HTML body of the email template

folderIdinteger nullable

ID of the folder to place the template in

folderType'personal' | 'team' required

Type of the folder

attachmentIdsinteger[]

List of previously uploaded attachment IDs to associate with the template

Example request

{
  "name": "Welcome email",
  "subject": "Welcome to our service",
  "body": "<p>Hello {{firstName}},</p><p>Welcome aboard!</p>",
  "folderId": 5,
  "folderType": "personal",
  "attachmentIds": [
    42,
    43
  ]
}

Response

Email template created successfully

idinteger

Unique identifier for the email template

namestring

Name of the email template

subjectstring nullable

Email subject line

bodystring

HTML body of the email template

folderIdinteger nullable

ID of the folder containing this template

folderTypestring nullable

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

createdAtstring date-time

Timestamp when the template was created

updatedAtstring date-time

Timestamp when the template was last updated

Example response

{
  "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"
}