# Customer.io Automations API

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

Customer.io Automations API is one of 48 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. This API exposes 6 JSON Schema definitions. Tagged areas include Automation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

An automation, sometimes referred to as a campaign, is a workflow that people in your audience trigger and traverse. The items that happen within the workflow—messages, attribute changes, webhooks, etc that your audience triggers—are called actions. These endpoints return information about automations including metrics and the actions included in automations. You can update individual automation actions from these endpoints, but you must perform all other create, update, and/or delete operations through the UI.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/campaigns` | List automations |
| GET | `/v1/campaigns/{campaign_id}` | Get an automation |
| GET | `/v1/campaigns/{campaign_id}/metrics` | Get automation metrics |
| GET | `/v1/campaigns/{campaign_id}/metrics/links` | Get automation link metrics |
| GET | `/v1/campaigns/{campaign_id}/actions` | List automation actions |
| GET | `/v1/campaigns/{campaign_id}/messages` | Get automation message metadata |
| GET | `/v1/campaigns/{campaign_id}/actions/{action_id}` | Get an automation action |
| PUT | `/v1/campaigns/{campaign_id}/actions/{action_id}` | Update an automation action |
| GET | `/v1/campaigns/{campaign_id}/actions/{action_id}/language/{language}` | Get a translation of an automation message |
| PUT | `/v1/campaigns/{campaign_id}/actions/{action_id}/language/{language}` | Update a translation of an automation message |
| GET | `/v1/campaigns/{campaign_id}/actions/{action_id}/metrics` | Get automation action metrics |
| GET | `/v1/campaigns/{campaign_id}/actions/{action_id}/metrics/links` | Get link metrics for an action |
| GET | `/v1/campaigns/{campaign_id}/journey_metrics` | Get automation journey metrics |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-automations-api-openapi.yml
- **Documentation** — https://docs.customer.io/integrations/api/app/
- **Documentation** — https://docs.customer.io/integrations/data-in/connections/http-api/
- **Documentation** — https://docs.customer.io/integrations/api/customerio-apis/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-campaign-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-transformers-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-campaign-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-newsletter-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-activity-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-anonymous-events-request-schema.json

## 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 Broadcasts API](https://apis.io/apis/customer-io/customer-io-broadcasts-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

Automation

---

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