# Customer.io Track V2 API

**Canonical:** https://apis.io/apis/customer-io/customer-io-track-v2-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 Track V2 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. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This version of our edge API has only two endpoints, but supports the majority of our traditional v1 track operations and then some based on the `type` and `action` keys that you set in your request. You can use the `/batch` call to send multiple requests at the same time. Unlike the v1 API, you can also make requests affecting objects and deliveries. Objects are a grouping mechanism for people—like an account people belong to or an online course that they enroll in. Deliveries are events based on messages sent from Customer.io. The chart below lists the type of `action` you can perform for each `type`. Our requests below are broken out by `type`; use the `action` dropdown to see the specific payload structure for each action. | Action | Person | Object | Delivery | | :-- | :--: | :--: | :--: | | identify | ✅ | ✅ | | | delete | ✅ | ✅ | | | event | ✅ | | ✅ | | screen | ✅ | | | | page | ✅ | | | | add_relationships | ✅ | ✅ | | | delete_relationships | ✅ | ✅ | | | add_device | ✅ | | | | delete_device | ✅ | | | | merge | ✅ | | | | suppress | ✅ | | | | unsuppress | ✅ | | |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-track-v2-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 Broadcasts API](https://apis.io/apis/customer-io/customer-io-broadcasts-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/)

---

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