Skip to main content
POST
Ensure a draft email message
If a draft email message already exists, it is returned unchanged. Otherwise a new empty draft is created (seeded from the most recent published version when present). Use the returned draftEmailMessageId and draftEmailMessageContentRevisionId when calling Update an email message to edit the draft’s content.

Authorizations

Authorization
string
header
required

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

Path Parameters

transactionalId
string
required

The ID of the transactional email.

Response

Draft ready.

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