Customer.io

Customer.io Track V2 API

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 | ✅ | | |

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/v2/entity Create, update or delete one person or object · Make a single request #
Ask an LLM
“How do I update a single person or object with the v2 Track API?”
“Can I relate a person to an object in one request?”
Tell an agent
Send a single entity request to update this person.
Create an account object and relate it to a person in one call.
POST /api/v2/batch Send many person and object operations at once · Send multiple requests #
Ask an LLM
“How do I send updates for lots of people and objects in one v2 request?”
“Can I mix person and object operations in a single batch?”
Tell an agent
Send these entity operations as a v2 batch: {batch}.
Batch-update these people and objects: {batch}.

Documentation

📖
Documentation
https://docs.customer.io/integrations/api/app/
📖
Documentation
https://docs.customer.io/integrations/data-in/connections/http-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-track-v2-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/customer-io:customer-io-track-v2-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

customer-io-track-v2-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Customer.io Track Track V2 API
  description: '# Overview


    Our Track API provides ways to send real-time customer data to your Customer.io workspace including customer identification and event tracking.'
servers:
- url: https://track.customer.io
  description: The base URL for the Track API. Track endpoints use basic authentication with your Site ID as the user name and your secret key as the password.
- url: https://track-eu.customer.io
  description: The base URL for the Track API (EU region). Track endpoints use basic authentication with your Site ID as the user name and your secret key as the password.
tags:


# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-track-v2-api-openapi.yml