Ad-hoc mass emails to a filtered set of clients with per-client Liquid token rendering. Provides draft CRUD, a pre-send resolved recipient list with skip warnings (missing contacts, email contact preference), per-client preview, test send to the current user, async sending with progress counters, a per-client delivery log, and cancellation. Recipient selection combines client filters with hand-picked additions and exclusions; recipients are resolved from client contact types, user types (manager/partner/associate/service manager), and static addresses — the same configuration shape as SendEmail workflow steps.

Create Email Broadcast

POST /tenants/{tenant}/email-broadcasts

Creates a draft email broadcast. Content is either a content block (category: Email) or an inline subject and body with Liquid tokens — not both. Recipient selection combines an optional client filter with hand-picked additions and exclusions. Requires the tenant to have connected at least one of their own send-enabled email accounts — broadcasts cannot be sent from the shared system mailbox.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code

Request Body*

CreateEmailBroadcastRequest

{
  "contentBlockCode": "string",
  "subjectLine": "string",
  "bodyHtml": "string",
  "allContacts": false,
  "recipientIncludeBusinessEmail": false
}

Responses

201 Created

EmailBroadcastDto

400 Bad Request

401 Unauthorized – Invalid or missing API key