White-label emails

Per-account email-template customization (copy, regions, delivery method, logs, test sends).

Per-account email-template customization (copy, regions, delivery method, logs, test sends).

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

MethodEndpointDescription
POSTList email template typesList every email-template type from the catalog merged with the company's own override flags (enabled state, delivery method, logo visibility, customised flag).
POSTGet template variables for a typeReturns the list of supported variable tokens (with sample values) usable in the header/body/footer/signature content for one template type.
POSTGet a single template (editor payload)Loads the full editor payload for one template type: raw override regions (null = inherit), resolved effective content, catalog defaults, theme color, and current settings (enabled, delivery method, logo visibility).
POSTSave (upsert) a template overrideCreate or updates the company's content override for a template type.
POSTPreview a template (render-only)Renders the template with sample variable values and returns the resulting HTML + resolved subject.
POSTEnable/disable a template typeEnable or disables sending for a template type.
POSTSet delivery method (direct/webhook)Switches a template type between Direct Send (email) and Webhook delivery.
POSTSet logo visibilityControls whether the white-label partner logo is shown in the email header for a template type (defaults to visible).
POSTList delivery logsReturns a paginated log of all email/webhook delivery attempts for the company, newest first, filterable by type, status, recipient, and date range.
POSTRestore template to system defaultsClear the company's content overrides (header, body, footer, signature, subject_override) for a type, reverting to system/white-label defaults.
POSTSend a test email to yourselfSend a real test email (subject prefixed with [Test] ) to the authenticated user's own email address, using sample variable values and any posted draft regions.