Skip to main content
POST
Create a transactional email
This endpoint creates a transactional email and an empty draft email message in one step. Use the returned draftEmailMessageId and draftEmailMessageContentRevisionId when calling the Update email message endpoint to set subject, sender, preview text, and LMX content Call Publish transactional email draft to publish.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

The name of the transactional email.

Example:

"Welcome email"

transactionalGroupId
string

The ID of the group to add this transactional email to. Defaults to the team's default group when omitted.

Response

Transactional email created.

id
string
required

The ID of the transactional email.

name
string
required

The name of the transactional email.

draftEmailMessageId
string | null
required

The ID of the draft email message.

draftEmailMessageContentRevisionId
string | null
required

The contentRevisionId of the draft email message. Pass this as expectedRevisionId on your first update via POST /v1/email-messages/{emailMessageId}.

publishedEmailMessageId
string | null
required

The ID of the published email message. null if there is no published version.

createdAt
string<date-time>
required

ISO 8601 timestamp for when the transactional email was created.

updatedAt
string<date-time>
required

ISO 8601 timestamp for when the transactional email was last updated.

dataVariables
string[]
required

Data variable names used by the published email. Empty for unpublished transactional emails.

transactionalGroupId
string | null

The ID of the group this transactional email belongs to. Returned when creating a transactional email.

Last modified on July 20, 2026