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.

Send Email Broadcast

POST /tenants/{tenant}/email-broadcasts/{code}/send

Sends a draft broadcast: re-evaluates the client selection, snapshots each client's resolved recipients (the audit record), marks the broadcast Queued and enqueues background processing. Poll the broadcast for progress and the recipients endpoint for the per-client delivery log. When the optional body sets scheduledAt, the broadcast is not sent now: it moves to Scheduled status and is dispatched at that time — recipients are resolved and snapshotted at dispatch, not schedule time.

Parameters

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

Request Body

SendEmailBroadcastRequest

{
  "scheduledAt": "2024-01-01T00:00:00Z"
}

Responses

202 Accepted

EmailBroadcastDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found