# broadcast.completed

HTML: https://www.app2email.com/docs/api/webhooks/broadcast.completed · Index: https://www.app2email.com/docs/api/llms.txt

A broadcast finished sending, was cancelled, or its scheduled time was missed.

Group: Broadcasts. Header `X-App2email-Event: broadcast.completed`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.code` | string | yes |  |
| `data.name` | string |  |  |
| `data.status` | string | yes | one of: `completed`, `cancelled`, `missed` |
| `data.sent_by` | string |  |  |
| `data.numbers` | integer |  |  |
| `data.posted` | integer |  |  |
| `data.accepted` | integer |  |  |
| `data.errors` | integer |  |  |
| `data.skipped_do_not_call` | integer |  |  |
| `data.skipped_monthly_limit` | integer |  |  |
| `data.status_url` | string |  |  |
| `data.report_url` | string |  |  |

## Samples

### completed

```json
{
  "id": "evt_Xq3k9m2Lw8Rt5Yp1Zs01",
  "type": "broadcast.completed",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "code": "k3XbQ9rTzP2mWv7a1c9e",
    "name": "October newsletter",
    "status": "completed",
    "sent_by": "dashboard",
    "numbers": 3,
    "posted": 3,
    "accepted": 3,
    "errors": 0,
    "skipped_do_not_call": 0,
    "skipped_monthly_limit": 0,
    "status_url": "https://api.app2email.com/v1/4976659348270/broadcasts/k3XbQ9rTzP2mWv7a1c9e",
    "report_url": "https://www.app2email.com/dashboard/log/broadcast/k3XbQ9rTzP2mWv7a1c9e"
  }
}
```

## Caused by

- [Send a WhatsApp message: template, or free-form reply](https://www.app2email.com/docs/api/messages/send-template-message.md): `POST /v1/{number}/messages`
- [Cancel a scheduled or sending API broadcast](https://www.app2email.com/docs/api/broadcasts/cancel-broadcast.md): `POST /v1/{number}/broadcasts/{code}/cancel`
- [Delete a contact record](https://www.app2email.com/docs/api/contacts/delete-contact.md): `DELETE /v1/{number}/contacts/{identity}`
- [Approve a held send: it is sent now](https://www.app2email.com/docs/api/approvals/approve-send.md): `POST /v1/{number}/approvals/{id}/approve`
- [Book an appointment for a customer at a free slot](https://www.app2email.com/docs/api/book-and-pay/create-booking.md): `POST /v1/{number}/bookings`
- [Cancel an appointment](https://www.app2email.com/docs/api/book-and-pay/cancel-booking.md): `POST /v1/{number}/bookings/{id}/cancel`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=broadcast.completed
