# Compose 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), `templateId`, `audienceFilter` (the rule that chose the list, kept for the reader and never re-run) and `retargetOfBlastId`. It starts as a draft with NO audience and no time: add the people with `post_blasts_id_audience`, name the moment with `post_blasts_id_schedule`, and `post_blasts_id_dispatch` is the verb that actually sends it. For one message to one person, `post_comms_send`.

Access class: `workspace`.

## Endpoint

`POST /v1/blasts`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "audienceFilter": {},
    "body": "string",
    "kind": "string",
    "name": "string",
    "retargetOfBlastId": 1,
    "subject": "string",
    "templateId": 1
  },
  "params": {},
  "query": {}
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "audienceFilter": {},
    "audienceFrozenAt": "string",
    "body": "string",
    "cancellationReason": "string",
    "cancelledAt": "string",
    "createdAt": "string",
    "createdByUserId": 1,
    "detail": {},
    "id": 1,
    "kind": "string",
    "name": "string",
    "retargetOfBlastId": 1,
    "scheduledAt": "string",
    "sentAt": "string",
    "status": "string",
    "subject": "string",
    "templateId": 1,
    "updatedAt": "string"
  }
}
```

### default

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.

Content type: `application/json`.

```json
{
  "error": "string"
}
```