Customer.io website screenshot

Customer.io

Customer.io is a customer engagement platform that combines a customer data platform, marketing automation, and messaging delivery to send behavior-triggered email, push, SMS, and in-app messages. Its API surface includes the Track API for sending behavioral data and customer profile updates, the App API for managing workspace resources and sending transactional and broadcast messages, the Pipelines API which is a Segment-spec data ingestion interface, and outbound reporting webhooks that deliver message lifecycle events.

Customer.io publishes 26 APIs on the APIs.io network, including Track API, Activities API, Alias API, and 23 more. Tagged areas include Behavioral Data, Broadcasts, Campaigns, CDP, and Customer Data.

The Customer.io catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 3 Spectral governance rulesets.

Customer.io’s developer surface includes authentication, documentation, CLI, changelog, sandbox, API reference, getting-started guide, and 47 more developer resources.

87.5/100 exemplar ▬ flat Agent 46/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
AccessPaidSelf serve
27 APIs 1 MCP Servers
Behavioral DataBroadcastsCampaignsCDPCustomer DataCustomer Data PlatformData IngestionEmailEvent TrackingMarketing AutomationMessagingPush NotificationsSegmentsSMSTransactional Email

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 87.5/100 · exemplar
Contract Quality 16.3 / 21
Developer Ergonomics 13.7 / 17
Access Clarity 15.9 / 17
Operational Transparency 9.3 / 11
Contract Governance 5.8 / 10
Discoverability 7.9 / 9
Regulatory Posture 11.0 / 15
Agent readiness — 46/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 0 / 6
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Telecommunications regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/customer-io: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 27

Individual APIs this provider publishes, each with its own machine-readable definition.

Customer.io Track API

The Customer.io Track API allows developers to send behavioral data and customer profile information into Customer.io. It provides endpoints for identifying customers, tracking ...

Customer.io Activities API

Retrieve activity logs for your workspace.

Customer.io Alias API

Merge two user identities by creating an alias linking a new identity to an existing one.

Customer.io Batch API

Send multiple API calls in a single request for improved performance.

Customer.io Broadcasts API

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

Customer.io Campaigns API

Retrieve information about campaigns, campaign actions, and campaign metrics in your workspace.

Customer.io Collections API

Manage collections of data used in message personalization.

Customer.io Customers API

Look up customer profiles, search for customers, and retrieve customer attributes and activity data.

Customer.io Devices API

Manage push notification devices associated with customer profiles.

Customer.io Entity API

Track API v2 entity endpoint for creating and managing people and objects using a unified request format.

Customer.io Events API

Track customer events and anonymous events to record behavioral data and trigger messaging workflows.

Customer.io Exports API

Export customer data, deliveries, and other information from your workspace.

Customer.io Group API

Associate people with groups or organizations.

Customer.io Identify API

Identify people and set their profile attributes. The identify call tells Customer.io who the current user is and assigns traits to them.

Customer.io Merge API

Merge two customer profiles into a single profile.

Customer.io Messages API

Retrieve information about individual messages sent to customers.

Customer.io Newsletters API

Retrieve information about newsletters and newsletter variants.

Customer.io Page API

Record page views from web applications.

Customer.io Screen API

Record screen views from mobile applications.

Customer.io Segments API

Create and manage manual segments, and retrieve segment membership information.

Customer.io Sender Identities API

Manage sender identities used for sending messages.

Customer.io Snippets API

Manage reusable content snippets for use in messages.

Customer.io Transactional API

Send transactional messages such as password resets, purchase receipts, and other important notifications triggered by user actions.

Customer.io App API

The Customer.io App API is the workspace-management and outbound-messaging surface: trigger broadcasts, send transactional email, push, SMS, in-app and inbox messages, manage ca...

Customer.io Pipelines API

The Customer.io Pipelines (CDP) API is the Segment-spec data ingestion interface Customer.io recommends for new integrations — identify, track, page, screen, group, alias and ba...

Customer.io Reporting Webhooks

Customer.io's outbound message-lifecycle event stream. Eight event families — customer, email, sms, whatsapp, push, in_app, slack and webhook — each carrying a metric such as dr...

Customer.io MCP

Customer.io's first-party hosted Model Context Protocol server. It exposes the full Journeys App API and CDP Data Pipelines API to any MCP client through eight tools — a context...

Scroll for all 27

Open Collections 26

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

Customer.io App API

OPEN COLLECTION

Customer.io Pipelines API

OPEN COLLECTION

Scroll for all 26

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Customer.io MCP

Customer.io operates a first-party, hosted Model Context Protocol server that exposes the full Journeys App API and the CDP Data Pipelines API to any MCP client. It is a remote ...

MCP SERVER

GraphQL 1

GraphQL schemas published by this provider.

Customer.io GraphQL Schema

This conceptual GraphQL schema represents the Customer.io messaging and marketing automation platform. Customer.io provides APIs for tracking behavioral data, managing customer ...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Customer Io Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Customer.io Reporting Webhooks

Customer.io Reporting Webhooks send real-time message activity events as JSON payloads via HTTP POST to a configured endpoint. These events include message sends, deliveries, op...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Customer Io Context

0 classes · 11 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Customer.io API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

Customer.io API Rules

6 rules · 5 warnings 1 info

SPECTRAL

Customer.io API Rules

6 rules · 3 errors 3 warnings

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Customer.io Customer

8 properties

JSON SCHEMA

Customer.io Event

7 properties

JSON SCHEMA

Customer.io Reporting Webhook Payload

4 properties

JSON SCHEMA

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Customer Io Authentication

http/oauth2 · 5 schemes

SECURITY

Customer Io Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Customer Io Vulnerability Disclosure

disclosure policy published

SECURITY

Customer Io Trust Center

SOC 2, ISO 27001, HIPAA, GDPR, CCPA

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Customer Io Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Customer Io Agentic Access

52 operations · 29 acting

52 operations · 29 acting

AGENTIC

Resources

Get Started 5

Portal, sign-up, and the first successful call

Documentation 6

Reference material describing how the API behaves

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 9

Pagination, idempotency, versioning, errors, and events

Scroll for all 9

Build 5

SDKs, sample code, and the tooling you integrate with

Access & Security 7

Authentication, authorization, and security posture

Scroll for all 7

Learn 1

Tutorials, courses, talks, and written guidance

Operate 4

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 3

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: customer-io
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/customer-io.png
url: https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/apis.yml
apis:
- aid: customer-io:track-api
  name: Customer.io Track API
  tags:
  - Behavioral Data
  - Customer Data
  - Event Tracking
  - Marketing Automation
  - Messaging
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://track.customer.io
  humanURL: https://docs.customer.io/integrations/api/track/
  properties:
  - url: https://docs.customer.io/integrations/api/track/
    type: Documentation
  - url: openapi/customer-io-track-api-openapi.yml
    type: OpenAPI
  - url: graphql/customer-io-graphql.md
    type: GraphQL
  description: The Customer.io Track API allows developers to send behavioral data and customer profile information into Customer.io.
    It provides endpoints for identifying customers, tracking events, managing devices for push notifications, and sending
    anonymous events. The API uses basic authentication with a Site ID and API key, and accepts JSON request bodies.
- aid: customer-io:customer-io-activities-api
  name: Customer.io Activities API
  description: Retrieve activity logs for your workspace.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Activities
  properties:
  - type: OpenAPI
    url: openapi/customer-io-activities-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-alias-api
  name: Customer.io Alias API
  description: Merge two user identities by creating an alias linking a new identity to an existing one.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://cdp.customer.io/v1
  tags:
  - Alias
  properties:
  - type: OpenAPI
    url: openapi/customer-io-alias-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-batch-api
  name: Customer.io Batch API
  description: Send multiple API calls in a single request for improved performance.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Batch
  properties:
  - type: OpenAPI
    url: openapi/customer-io-batch-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-broadcasts-api
  name: Customer.io Broadcasts API
  description: Trigger API-triggered broadcasts to send messages to groups of people based on segments or filters.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Broadcasts
  properties:
  - type: OpenAPI
    url: openapi/customer-io-broadcasts-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-campaigns-api
  name: Customer.io Campaigns API
  description: Retrieve information about campaigns, campaign actions, and campaign metrics in your workspace.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/customer-io-campaigns-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-collections-api
  name: Customer.io Collections API
  description: Manage collections of data used in message personalization.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Collection
  tags_raw:
  - Collections
  properties:
  - type: OpenAPI
    url: openapi/customer-io-collections-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-customers-api
  name: Customer.io Customers API
  description: Look up customer profiles, search for customers, and retrieve customer attributes and activity data.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/customer-io-customers-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-devices-api
  name: Customer.io Devices API
  description: Manage push notification devices associated with customer profiles.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Devices
  properties:
  - type: OpenAPI
    url: openapi/customer-io-devices-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-entity-api
  name: Customer.io Entity API
  description: Track API v2 entity endpoint for creating and managing people and objects using a unified request format.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Entity
  properties:
  - type: OpenAPI
    url: openapi/customer-io-entity-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-events-api
  name: Customer.io Events API
  description: Track customer events and anonymous events to record behavioral data and trigger messaging workflows.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/customer-io-events-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-exports-api
  name: Customer.io Exports API
  description: Export customer data, deliveries, and other information from your workspace.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Export
  tags_raw:
  - Exports
  properties:
  - type: OpenAPI
    url: openapi/customer-io-exports-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-group-api
  name: Customer.io Group API
  description: Associate people with groups or organizations.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://cdp.customer.io/v1
  tags:
  - Group
  properties:
  - type: OpenAPI
    url: openapi/customer-io-group-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-identify-api
  name: Customer.io Identify API
  description: Identify people and set their profile attributes. The identify call tells Customer.io who the current user
    is and assigns traits to them.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://cdp.customer.io/v1
  tags:
  - Identify
  properties:
  - type: OpenAPI
    url: openapi/customer-io-identify-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-merge-api
  name: Customer.io Merge API
  description: Merge two customer profiles into a single profile.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Merge
  properties:
  - type: OpenAPI
    url: openapi/customer-io-merge-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-messages-api
  name: Customer.io Messages API
  description: Retrieve information about individual messages sent to customers.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Message
  tags_raw:
  - Messages
  properties:
  - type: OpenAPI
    url: openapi/customer-io-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-newsletters-api
  name: Customer.io Newsletters API
  description: Retrieve information about newsletters and newsletter variants.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Newsletters
  properties:
  - type: OpenAPI
    url: openapi/customer-io-newsletters-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-page-api
  name: Customer.io Page API
  description: Record page views from web applications.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://cdp.customer.io/v1
  tags:
  - Page
  properties:
  - type: OpenAPI
    url: openapi/customer-io-page-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-screen-api
  name: Customer.io Screen API
  description: Record screen views from mobile applications.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://cdp.customer.io/v1
  tags:
  - Screen
  properties:
  - type: OpenAPI
    url: openapi/customer-io-screen-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-segments-api
  name: Customer.io Segments API
  description: Create and manage manual segments, and retrieve segment membership information.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Segments
  properties:
  - type: OpenAPI
    url: openapi/customer-io-segments-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-sender-identities-api
  name: Customer.io Sender Identities API
  description: Manage sender identities used for sending messages.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Sender Identities
  properties:
  - type: OpenAPI
    url: openapi/customer-io-sender-identities-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-snippets-api
  name: Customer.io Snippets API
  description: Manage reusable content snippets for use in messages.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Snippets
  properties:
  - type: OpenAPI
    url: openapi/customer-io-snippets-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:customer-io-transactional-api
  name: Customer.io Transactional API
  description: Send transactional messages such as password resets, purchase receipts, and other important notifications triggered
    by user actions.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://api.customer.io
  tags:
  - Transactional
  properties:
  - type: OpenAPI
    url: openapi/customer-io-transactional-api-openapi.yml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:app-api
  name: Customer.io App API
  description: 'The Customer.io App API is the workspace-management and outbound-messaging surface: trigger broadcasts, send
    transactional email, push, SMS, in-app and inbox messages, manage campaigns, newsletters, segments, snippets, collections,
    Design Studio content and assets, read delivery metrics, and export people and delivery data. This entry points at the
    166-operation OpenAPI 3.1.0 document Customer.io publishes itself. Authorization is a bearer App API Key, with service-account
    tokens (sa_live_) additionally accepted on the transactional send endpoints.'
  baseURL: https://api.customer.io
  humanURL: https://docs.customer.io/integrations/api/app/
  tags:
  - Broadcasts
  - Campaigns
  - Messaging
  - Transactional Email
  - Newsletters
  - Segments
  properties:
  - type: OpenAPI
    url: openapi/_original/customer-io-app-api-openapi.json
  - type: Overlay
    url: overlays/customer-io-app-api-overlay.yaml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/app/
  - type: APIReference
    url: https://docs.customer.io/integrations/api/customerio-apis/
- aid: customer-io:pipelines-api
  name: Customer.io Pipelines API
  description: The Customer.io Pipelines (CDP) API is the Segment-spec data ingestion interface Customer.io recommends for
    new integrations — identify, track, page, screen, group, alias and batch, all POST-only, with deletes and other state
    changes expressed as semantic events rather than HTTP verbs. This entry points at the OpenAPI 3.1.0 document Customer.io
    publishes itself. Authorization is HTTP basic with the CDP API key as the username and a blank password.
  baseURL: https://cdp.customer.io/v1
  humanURL: https://docs.customer.io/integrations/data-in/connections/http-api/
  tags:
  - CDP
  - Data Ingestion
  - Customer Data
  - Event Tracking
  properties:
  - type: OpenAPI
    url: openapi/_original/customer-io-pipelines-api-openapi.json
  - type: Overlay
    url: overlays/customer-io-pipelines-api-overlay.yaml
  - type: Documentation
    url: https://docs.customer.io/integrations/data-in/connections/http-api/
- aid: customer-io:reporting-webhooks
  name: Customer.io Reporting Webhooks
  description: Customer.io's outbound message-lifecycle event stream. Eight event families — customer, email, sms, whatsapp,
    push, in_app, slack and webhook — each carrying a metric such as drafted, sent, delivered, opened, clicked, converted,
    bounced, spammed or failed, plus the full set of foreign keys that tie the event back to the delivery, person, campaign,
    broadcast, newsletter and journey that produced it. Requests are signed with x-cio-signature, an HMAC-SHA256 of the body,
    and stamped with x-cio-timestamp.
  baseURL: https://api.customer.io
  humanURL: https://docs.customer.io/integrations/api/webhooks/
  tags:
  - Webhook
  - Event
  - Reporting
  - Messaging
  tags_raw:
  - Webhooks
  - Events
  - Reporting
  - Messaging
  properties:
  - type: OpenAPI
    url: openapi/_original/customer-io-reporting-webhooks-openapi.json
  - type: Webhooks
    url: openapi/_original/customer-io-reporting-webhooks-openapi.json
  - type: AsyncAPI
    url: asyncapi/customer-io-reporting-webhooks-asyncapi.yml
  - type: Overlay
    url: overlays/customer-io-reporting-webhooks-overlay.yaml
  - type: Documentation
    url: https://docs.customer.io/integrations/api/webhooks/
- aid: customer-io:mcp
  name: Customer.io MCP
  description: Customer.io's first-party hosted Model Context Protocol server. It exposes the full Journeys App API and CDP
    Data Pipelines API to any MCP client through eight tools — a context primer, a schema browser, three verb-scoped HTTP
    proxies split so reads can be approved independently of writes and deletes, a two-tool skill library, and an auth-status
    probe. Authorization is OAuth 2.1 with PKCE and dynamic client registration, bound to the authorizing user's own Customer.io
    permissions.
  baseURL: https://mcp.customer.io/mcp
  humanURL: https://docs.customer.io/ai/mcp/get-started/
  tags:
  - MCP
  - Agents
  - Artificial Intelligence
  tags_raw:
  - MCP
  - Agents
  - AI
  properties:
  - type: MCPServer
    url: mcp/customer-io-mcp.yml
  - type: ToolCrosswalk
    url: mcp/customer-io-tool-crosswalk.yml
  - type: OAuthScopes
    url: scopes/customer-io-scopes.yml
  - type: Documentation
    url: https://docs.customer.io/ai/mcp/get-started/
common:
- type: Plans
  url: plans/customer-io-plans-pricing.yml
- type: RateLimits
  url: rate-limits/customer-io-rate-limits.yml
- type: FinOps
  url: finops/customer-io-finops.yml
- type: AgenticAccess
  url: agentic-access/customer-io-agentic-access.yml
- type: TrustCenter
  url: security/customer-io-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/customer-io-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/customer-io-domain-security.yml
- type: Authentication
  url: authentication/customer-io-authentication.yml
- type: GitHubOrganization
  url: https://github.com/customerio
- type: LinkedIn
  url: https://www.linkedin.com/company/customer-io
- type: Website
  url: https://customer.io
- type: Documentation
  url: https://docs.customer.io
- type: AsyncAPI
  url: asyncapi/customer-io-reporting-webhooks-asyncapi.yml
- type: JSONSchema
  url: json-schema/customer-io-customer-schema.json
- type: JSONSchema
  url: json-schema/customer-io-event-schema.json
- type: JSONSchema
  url: json-schema/customer-io-webhook-payload-schema.json
- type: JSONLD
  url: json-ld/customer-io-context.jsonld
- type: Vocabulary
  url: vocabulary/customer-io-vocabulary.yml
- type: Rules
  url: rules/customer-io-rules.yml
- type: Integrations
  url: https://customer.io/integrations
- type: LlmsText
  url: https://docs.customer.io/llms.txt
- type: Packages
  url: packages/customer-io-packages.yml
- type: SDKs
  url: packages/customer-io-packages.yml
- type: CLI
  url: cli/customer-io-cli.yml
- type: MCPServer
  url: mcp/customer-io-mcp.yml
- type: ToolCrosswalk
  url: mcp/customer-io-tool-crosswalk.yml
- type: AgentCard
  url: a2a/customer-io-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: WellKnown
  url: well-known/customer-io-well-known.yml
- type: LLMsTxt
  url: llms/customer-io-llms.txt
- type: OAuthScopes
  url: scopes/customer-io-scopes.yml
- type: Conventions
  url: conventions/customer-io-conventions.yml
- type: ErrorCatalog
  url: errors/customer-io-problem-types.yml
- type: Lifecycle
  url: lifecycle/customer-io-lifecycle.yml
- type: StatusPage
  url: https://status.customerio.com
- type: ChangeLog
  url: changelog/customer-io-changelog.yml
- type: Conformance
  url: conformance/customer-io-conformance.yml
- type: Compliance
  url: conformance/customer-io-conformance.yml
- type: Security
  url: https://customer.io/legal/reporting-vulnerability
- type: DataModel
  url: data-model/customer-io-data-model.yml
- type: Sandbox
  url: sandbox/customer-io-sandbox.yml
- type: Webhooks
  url: openapi/_original/customer-io-reporting-webhooks-openapi.json
- type: Overlay
  url: overlays/customer-io-app-api-overlay.yaml
- type: APICatalog
  url: well-known/customer-io-api-catalog.json
- type: DeveloperPortal
  url: https://docs.customer.io/integrations/api/customerio-apis/
- type: APIReference
  url: https://docs.customer.io/integrations/api/customerio-apis/
- type: GettingStarted
  url: https://docs.customer.io/get-started/
- type: Support
  url: https://customer.io/contact
- type: Blog
  url: https://customer.io/blog/
- type: Pricing
  url: https://customer.io/pricing
- type: SignUp
  url: https://fly.customer.io/signup
- type: Login
  url: https://fly.customer.io/login
- type: TermsOfService
  url: https://customer.io/legal/terms-of-service
- type: PrivacyPolicy
  url: https://customer.io/legal/privacy-policy
- type: Academy
  url: https://academy.customer.io/pages/get-started
integrations:
- name: See all integrations See all integrations
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.23'
created: '2024-01-01'
modified: '2026-08-13'
name: Customer.io
tags:
- Behavioral Data
- Broadcasts
- Campaigns
- CDP
- Customer Data
- Customer Data Platform
- Data Ingestion
- Email
- Event Tracking
- Marketing Automation
- Messaging
- Push Notifications
- Segments
- SMS
- Transactional Email
description: Customer.io is a customer engagement platform that combines a customer data platform, marketing automation, and
  messaging delivery to send behavior-triggered email, push, SMS, and in-app messages. Its API surface includes the Track
  API for sending behavioral data and customer profile updates, the App API for managing workspace resources and sending transactional
  and broadcast messages, the Pipelines API which is a Segment-spec data ingestion interface, and outbound reporting webhooks
  that deliver message lifecycle events.
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 33
  pass: local-v1