Email templates

Create email template

Changed on

Create an email template as a DRAFT, from either a block document (like the drag-and-drop builder) or raw html. The deliverable HTML and plain text are produced server-side; {{path}} variables in the subject and body resolve at send. Publish it with email_templates_update (status PUBLISHED) before a journey can send it. Minimal blocks example: { "name": "Recordatorio", "subject": "Hola {{customer.name}}", "document": { "blocks": [ { "type": "heading", "text": "Tu pago vence pronto" }, { "type": "text", "text": "Hola {{customer.name}}, ..." }, { "type": "button", "text": "Pagar", "href": "https://..." }, { "type": "footer", "text": "Empresa, dirección" } ] } }.

post/api/v1/email-templates

Request

  • Base URL
    https://www.useboom.ai
  • Auth
    HTTP bearer

Request body

namestring required

Internal name, not shown to recipients.

subjectstring required

Subject line; may contain {{path}} variables.

htmlstring

Hand-written HTML (the template becomes an HTML template). Sanitized on save — scripts, event handlers and external stylesheets are removed and listed in removed. Variables use the same {{path}} grammar.

fromSenderIdstring nullable

Sender id to send From. Must be on the verified domain (usableAsFrom in journeys_email_templates). Null/omitted = the org default.

replyToSenderIdstring nullable

Sender id for Reply-To. Null/omitted = the org default.

Response

Success

removedstring[] required

What the HTML sanitizer removed. Empty for block content.

Changes