Skip to content

mail_template_publish

Publish a template: promote its open draft revision to live.

Tool

mail_template_publish

Publish a template: promote its open draft revision to live.

Publish a template: promote its open draft revision to live. No open draft is an idempotent no-op

Behavior

HTTP
POST /mail/templates/:id/publish

Arguments

Name
Type
Required
Description
id
string
•
Template id to publish

Response

Field
Type
Always
Description
id
string
•
Template id
html
string
•
HTML body; may contain {{ variable }} placeholders
name
string
•
Human label for the template
text
string
•
Plaintext body; null when none was supplied
status
string
•
Lifecycle status: published once a revision has gone live
subject
string
•
Email subject; may contain {{ variable }} placeholders
createdAt
string
•
When the template was created (ISO 8601 UTC)
updatedAt
string
•
When the template was last modified (ISO 8601 UTC)
variables
array
•
Declared variables of this template (at most 20)
archivedAt
string
•
When the template was archived (ISO 8601 UTC); null while it is listed normally. Archiving never stops a send
draftRevision
integer
•
Revision number of the open, unpublished draft; null when there is none
currentRevision
integer
•
Revision number a send renders; null until the template is first published

Try it

Publish a template: promote its open draft revision to live.

When to use

Publish a template: promote its open draft revision to live. No open draft is an idempotent no-op

Example

Ask your agent something like this:

Publish a template: promote its open draft revision to live.

The agent will invoke mail_template_publish with these arguments:

{
  "id": "<id>"
}

Esc

Start typing to search the docs.

↑↓navigate↵select