Update an email message
Update an email message’s subject, preview text, sender, or LMX content.
expectedRevisionId matching the current contentRevisionId.
Draft status.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the email message.
"cle5f7g9h1i3j5k7l9m1n3p5"
Body
The contentRevisionId you last fetched, or the emailMessageContentRevisionId you received when creating the campaign.
The email sender email address, without the team's sending domain.
"hello"
Reply-to email. Must be empty or a valid email address.
CC email address. Requires the team to have CC/BCC enabled.
BCC email address. Requires the team to have CC/BCC enabled.
ISO 639-1 language code for the email, e.g. en or fr.
The rendering format of the email.
styled, plain The email body serialized as LMX. Styles must be embedded in the LMX <Style /> tag.
Fallback values for contact properties, keyed by property name. Per-key merge: a string value sets the fallback, a null value deletes it, and keys omitted from the map are left unchanged.
Fallback values for event properties, keyed by property name. Per-key merge: a string value sets the fallback, a null value deletes it, and keys omitted from the map are left unchanged.
Fallback values for data variables, keyed by variable name. Per-key merge: a string value sets the fallback, a null value deletes it, and keys omitted from the map are left unchanged.
Response
Email message updated.
The ID of the email message.
"cle5f7g9h1i3j5k7l9m1n3p5"
The email subject.
"Spring product updates"
The email preview text.
"See what's new this season"
The email sender name.
"Acme Team"
The email sender email address, without the team's sending domain.
"hello"
The email reply-to address.
"support@company.com"
The rendering format of the email.
styled, plain "styled"
The email body serialized as LMX.
"<Paragraph>Hello, {firstName}!</Paragraph>"
The current content revision. Pass this as expectedRevisionId on your next update.
"clrev1s10n2i3d4e5f6g7h8"
"2025-06-29T07:47:39.370Z"
The campaign this email message belongs to. Present only when the message belongs to a campaign (mutually exclusive with transactionalId).
"clc4m6n8p0q2r4s6t8u0v2x4"
The transactional email this email message belongs to. Present only when the message belongs to a transactional email (mutually exclusive with campaignId).
The email CC address. Only present when set.
The email BCC address. Only present when set.
ISO 639-1 language code for the email, e.g. en or fr. Only present when set.
Fallback values for contact properties. Only present when set.
Fallback values for event properties. Only present when set.
Fallback values for data variables. Only present when set.
Non-fatal issues raised while compiling the submitted LMX. Only present on update responses when warnings were produced.
Related topics
Workflows API examplesLMXSupabase - Send emailsAPI IntroductionCreate a transactional email
