Creates a new email, or updates an existing email when the posted body includes a non-zero emailId. The URL path id is required by the route but is ignored by the endpoint — the server uses the emailId value from the JSON body. See Get Email for the full shape of the Email object.

idnumberrequired

Placeholder in the route. The actual target is taken from emailId in the request body; you can pass 0 here when creating.

{ "emailId": 0, "name": "Welcome Email", "campaignId": 69, "parentId": 0, "status": "Active", "from": "hello@example.com", "subject": "Welcome to Acme", "preheader": "Thanks for signing up", "body": "<p>Welcome!</p>", "plaintext": "Welcome!", "isEnabled": true, "isOpenTrackingEnabled": true, "isClickTrackingEnabled": true }

emailIdnumber

Id of the email to update. Omit or set to 0 to create a new email.

namestring

Display name of the email. Required.

campaignIdnumber

Id of the campaign this email belongs to. Required when creating.

parentIdnumber

Id of the parent email (used when replying "on top of" another email). Set to 0 for standalone emails.

statusstring

Email status. One of: Active, Paused, Archived, Deleted.

subject, preheader, from, replyTo, to, cc, bccstring

Standard email header fields. from is required for non-transactional sends; to is populated automatically at send time.

bodystring

The rendered HTML body of the email.

plaintextstring

Optional plaintext version of the body.

cssstring

Optional CSS stylesheet applied to the email.

componentsstring

Optional JSON payload used by the DailyStory email designer to round-trip structured edits.

ampstring

Optional AMP-for-Email variant.

descriptionstring

Internal description shown in the email list.

isEnabled, isWebViewEnabled, isOpenTrackingEnabled, isClickTrackingEnabled, isTransactional, isIgnoreAutoReplyboolean

Feature flags. isTransactional = true bypasses opt-out checks at send time.

Create or Update an Email