Customer.io

Customer.io Track Events API

Use customer events to trigger campaigns or add users to segments. You can attribute events directly to customers or send anonymous events and associate them with users later when you identify them.

GitHub OpenAPI

Operations 4

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/v1/customers/{identifier}/events Track an event for an identified person · Track a customer event #
Ask an LLM
“How do I send an event for a person I've already identified?”
“Can I send page and screen events through the person event endpoint?”
Tell an agent
Track an event for person {identifier}.
Record a purchase event on {identifier}'s profile.
POST /api/v1/events Track an event for an anonymous visitor · Track an anonymous event #
Ask an LLM
“How do I record events for visitors who haven't signed up yet?”
“Will anonymous events merge into the profile once someone is identified?”
Tell an agent
Track an anonymous event for a visitor.
Send an event with an anonymous ID before the user logs in.
POST /api/v1/metrics Report delivery metrics from any channel · Report metrics #
Ask an LLM
“How do I report opens or clicks from a channel you don't natively support?”
“Can I send delivery metrics back using the CIO-Delivery-ID?”
Tell an agent
Report an opened metric for a delivery.
Send a clicked metric back for a message we delivered.
POST /api/v1/push/events Report push notification metrics (legacy) · Report push metrics #
Ask an LLM
“How do I report push opens with the older push events endpoint?”
“Can I mark a push as delivered on a specific device?”
Tell an agent
Report {event} for push delivery {delivery_id}.
Mark push {delivery_id} as {event} on device {device_id} using the legacy endpoint.

Documentation

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

Specifications

⚙
OpenAPI
https://artifacts.apis.io/customer-io/openapi/customer-io-track-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/customer-io/json-schema/customer-io-anonymous-events-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/customer-io/json-schema/customer-io-events-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/customer-io/json-schema/customer-io-track-metrics-schema.json

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-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Customer.io Journeys API Reference Track Events API
  description: Customer.io provides REST APIs to send real-time customer data, retrieve data from your account, and trigger messages.
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.
- url: https://api.customer.io
  description: The base URL for broadcasts, transactional messages, and data-retrieval APIs. These endpoints use bearer authorization, and require a [token that you generate in the UI](https://fly.customer.io/settings/api_credentials?keyType=app).
- url: https://api-eu.customer.io
  description: The base URL for broadcasts, transactional messages, and data-retrieval APIs (EU region). These endpoints use bearer authorization, and require a [token that you generate in the UI](https://fly.customer.io/settings/api_credentials?keyType=app).
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/customer-io/openapi/customer-io-track-events-api-openapi.yml