/v1/blastsCompose a blast to many people
Composes a blast: ONE set of words aimed at many people, the same thing said to everyone on a list — this is the route for "email this whole list the same thing" or "text all of these people". Body: kind ("sms" or "email"), name (required, one per kind), body (the words), subject (email only, and required there), goal, sendFrom, templateId, audienceFilter (the rule that chose the list, kept for the reader and never re-run) and retargetOfBlastId. goal is what a reply should lead to, in a sentence — "book a 10-minute call about renewing; never quote a rate". Neo is handed it with every thread a copy is sent in, so it decides how replies are answered: always set one, and ask the person for it if they have not said. The words may carry merge fields, filled per recipient: {{first_name}} is a field and {{first_name|lead.name|"there"}} is an either/or — each step is tried in turn and the quoted one is used when none had a value. A recipient with nothing to fill a field and no quoted fallback is SKIPPED rather than sent a gap, so give every field a fallback (get_blasts_merge-fields lists the names). sendFrom is the line its copies leave on — a phone number for a text blast, a mailbox for an email one, taken from get_comms_senders; leave it out for the workspace's default line, and name it whenever the person says which number or mailbox to use. A line the caller may not send from is refused. It starts as a draft with NO audience and no time: aim it with post_blasts_id_audience_board, read get_blasts_id_preview, and post_blasts_id_dispatch is the verb that actually sends it. For one message to one person, post_comms_send. Messages worded for each person are not a blast, at any count: post_outreach_bulk-send sends up to 25 a call, each with its own words.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"audienceFilter": {},
"audienceFrozenAt": "2026-01-01T00:00:00Z",
"body": "string",
"bodyFormat": "string",
"cancellationReason": "string",
"cancelledAt": "2026-01-01T00:00:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"createdByUserId": 1,
"detail": {},
"goal": "string",
"id": 1,
"kind": "string",
"name": "string",
"retargetOfBlastId": 1,
"scheduledAt": "2026-01-01T00:00:00Z",
"sendFrom": "string",
"sentAt": "2026-01-01T00:00:00Z",
"status": "string",
"subject": "string",
"templateId": 1,
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}