# Customer.io Broadcasts API

**Canonical:** https://apis.io/apis/customer-io/customer-io-broadcasts-api/  
**Provider:** Customer.io — https://apis.io/providers/customer-io/  
**Base URL:** https://api.customer.io  
**Documentation:** https://docs.customer.io/integrations/api/track/

Customer.io Broadcasts API is one of 42 APIs that [Customer.io](https://apis.io/providers/customer-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Broadcast. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Trigger API-triggered broadcasts to send messages to groups of people based on segments or filters.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/campaigns/{broadcast_id}/triggers/{trigger_id}/errors` | Get broadcast error descriptions |
| GET | `/v1/broadcasts` | List broadcasts |
| GET | `/v1/broadcasts/{broadcast_id}` | Get a broadcast |
| GET | `/v1/campaigns/{broadcast_id}/triggers/{trigger_id}` | Get the status of a broadcast |
| GET | `/v1/broadcasts/{broadcast_id}/metrics` | Get broadcast metrics |
| GET | `/v1/broadcasts/{broadcast_id}/metrics/links` | Get broadcast link metrics |
| GET | `/v1/broadcasts/{broadcast_id}/actions` | List broadcast actions |
| GET | `/v1/broadcasts/{broadcast_id}/messages` | Get messages for a broadcast |
| GET | `/v1/broadcasts/{broadcast_id}/actions/{action_id}` | Get a broadcast action |
| PUT | `/v1/broadcasts/{broadcast_id}/actions/{action_id}` | Update a broadcast action |
| GET | `/v1/broadcasts/{broadcast_id}/actions/{action_id}/language/{language}` | Get a translation of a broadcast message |
| PUT | `/v1/broadcasts/{broadcast_id}/actions/{action_id}/language/{language}` | Update a translation of a broadcast message |
| GET | `/v1/broadcasts/{broadcast_id}/actions/{action_id}/metrics` | Get broadcast action metrics |
| GET | `/v1/broadcasts/{broadcast_id}/actions/{action_id}/metrics/links` | Get broadcast action link metrics |
| GET | `/v1/broadcasts/{broadcast_id}/triggers` | Get broadcast triggers |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-broadcasts-api-openapi.yml
- **Documentation** — https://docs.customer.io/integrations/api/app/
- **Documentation** — https://docs.customer.io/integrations/data-in/connections/http-api/

## Other Customer.io APIs (12)

- [Customer.io Track API](https://apis.io/apis/customer-io/track-api/)
- [Customer.io Activities API](https://apis.io/apis/customer-io/customer-io-activities-api/)
- [Customer.io Alias API](https://apis.io/apis/customer-io/customer-io-alias-api/)
- [Customer.io Batch API](https://apis.io/apis/customer-io/customer-io-batch-api/)
- [Customer.io Campaigns API](https://apis.io/apis/customer-io/customer-io-campaigns-api/)
- [Customer.io Collections API](https://apis.io/apis/customer-io/customer-io-collections-api/)
- [Customer.io Customers API](https://apis.io/apis/customer-io/customer-io-customers-api/)
- [Customer.io Exports API](https://apis.io/apis/customer-io/customer-io-exports-api/)
- [Customer.io Group API](https://apis.io/apis/customer-io/customer-io-group-api/)
- [Customer.io Identify API](https://apis.io/apis/customer-io/customer-io-identify-api/)
- [Customer.io Messages API](https://apis.io/apis/customer-io/customer-io-messages-api/)
- [Customer.io Newsletters API](https://apis.io/apis/customer-io/customer-io-newsletters-api/)

## Tags

Broadcast

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/customer-io/customer-io-broadcasts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/customer-io/.