Skip to main content

Preview Brand Report Email

POST 
/api/v2/brand-reports/:run/send-preview

Renders the email exactly as the first recipient would receive it (merge fields filled). Same body as Send Brand Report; recipients are optional.

Required scope: reports:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token (scope: reports, permission: brand_reports.send).

Body:

  • to[] (required, 1–50) — {email (required), name}
  • cc[] (max 20 emails)
  • subject (required, max 255) and body (required, HTML, max 100000) — merge fields such as {{brand_name}}, {{period_label}}, {{contact_first_name}}, {{summary_paragraph}}, {{share_url}} are filled per recipient
  • attachments.xlsx / attachments.pdf / attachments.link (boolean)
  • send_at (datetime, optional) — schedule the send instead of sending now (the report is approved and the message stored)
  • from_mode — merchant (your own sending domain) | system
  • summary (string, optional, max 10000) — the summary paragraph as edited in the send dialog; saved on the report before the attachments are built so the PDF, XLSX and share page carry the same words as the email (send only; omit to keep the stored summary)

Request​

Responses​

OK

Response Headers
    Content-Type