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 48 API contracts indexed on the APIs.io network, including Track API, Activities API, Alias API, and 45 more. Tagged areas include Behavioral Data, Broadcast, 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 59 more developer resources.

84.0/100 exemplar ▬ flat Agent 72/100 agent ready Front door AI 4/6 moderate saas Full breakdown ↓
scored 2026-10-17 · rubric v0.24.0
AccessPaidSelf serve
7 published contracts 1 MCP Servers
Behavioral DataBroadcastCampaignsCDPCustomer DataCustomer Data PlatformData IngestionEmailEvent TrackingMarketing AutomationMessagingPush NotificationsSegmentsSMSTransactional EmailA2A

What this lets a business do 2

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Customer Relationship Management
BC-420
AliasCustomersIdentifySegmentsTrack CustomersTrack Segments
POST /identify POST /v1/segments GET /v1/segments GET /v1/segments/{segment_id}
Marketing Management
BC-400
BroadcastsCampaignsDesign StudioNewsletters
GET /v1/broadcasts GET /v1/broadcasts/{broadcast_id}/metrics PUT /v1/broadcasts/{broadcast_id}/actions/{action_id} GET /v1/broadcasts/{broadcast_id}/actions/{action_id}/language/{language}

What people ask Customer.io 38

The questions people put to an LLM, and the jobs they hand an agent, that Customer.io's APIs answer — each one linked to the operation that does it. Generated by API Evangelist

Customer.io Broadcasts API Get validation errors for a broadcast trigger “Why did my API-triggered broadcast fail validation?” List API-triggered broadcasts “What API-triggered broadcasts do I have set up?” Get a broadcast “How do I look up the settings of one API-triggered broadcast?” Check the status of a broadcast trigger “Did the broadcast I just triggered finish processing?”
Customer.io Newsletter Variants API List a newsletter's content variants “What language and A/B test variants does my newsletter have?” Get one newsletter variant by content ID “How do I read the content of one specific newsletter variant?” Update a newsletter variant by content ID “How do I change the body or subject of a newsletter variant?” Add a translation to a newsletter “How do I add a French translation to my newsletter?”
Customer.io Assets API List file assets “How do I see all the images and PDFs uploaded to my asset library?” Upload a file asset “How do I upload an image or PDF to the asset library through the API?” Get a file asset “How do I look up the details of one uploaded file asset?” Rename or move a file asset “Can I rename an uploaded file asset without re-uploading it?”
Customer.io Customers API Find people by email address “How do I find a person's profile when I only know their email?” Search people by segment or attribute “How do I find everyone in a segment whose plan attribute is premium?” Get a person's attributes “What attributes are stored on a person's profile?” List objects a person is related to “Which companies or accounts is a person linked to?”
Customer.io Transactional API List transactional messages “What transactional message templates do I have?” Get a transactional message “How do I look up the settings of one transactional message?” List a transactional message's languages “Which languages is my transactional message translated into?” Overwrite a transactional message's content “How do I update the body of a transactional email template?”
Customer.io Send Messages API Trigger an API-triggered broadcast “How do I kick off an API-triggered broadcast with custom data?” Send a draft newsletter now “How do I send a draft newsletter immediately?” Schedule a draft newsletter “How do I schedule a newsletter to go out at a specific time?” Send a transactional email “How do I send a password reset email to one person?”
Customer.io Track Customers API Add or update a person “How do I create or update a person's profile with the Track API?” Delete a person “How do I delete a person and all their data?” Add or update a person's device “How do I register an iOS or Android push token for a person?” Remove a device from a person “How do I remove an old device from a person's profile?”
Customer.io Segments API Create a manual segment “How do I create an empty manual segment through the API?” List segments “What segments do I have in my workspace?” Get a segment “How do I look up one segment's details?” Delete a manual segment “How do I delete a manual segment?”
Customer.io Collections API Create a collection “How do I upload a lookup table of data I can reference in messages?” List collections “What data collections do I have for use in messages?” Get a collection “How do I look up one collection's name and schema?” Delete a collection “How do I remove a collection I no longer use?”
Customer.io Exports API List exports “What data exports have I run?” Check an export's status “Is my export finished yet?” Get a download link for an export “How do I download the file from a finished export?” Export people matching filters “How do I export a CSV of people who match certain filters?”
Customer.io Reporting Webhooks API Create a reporting webhook “How do I get message events like opens and clicks sent to my own URL?” List reporting webhooks “What reporting webhooks are configured in my workspace?” Get a reporting webhook “Which events does a particular reporting webhook send?” Update a reporting webhook “How do I change the URL a reporting webhook posts to?”
Customer.io ESP Suppression API Check whether an email is ESP-suppressed “Why isn't a particular address receiving our emails, is it suppressed?” List ESP-suppressed emails by reason “Which addresses have bounced or reported us as spam?” List ESP suppressions for a sending domain “Which addresses were suppressed on one of my sending domains?” Remove an address from ESP suppression “How do I un-suppress an email address that bounced?”

Showing 12 of 38 APIs with phrasing — see every API.

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-10-17 · rubric v0.24.0
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.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% 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/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. 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. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

MarketPositionDepthRegistered MCP serverDeclares compatibility
Commerce and CRM mixed 39.4 - 1
Martech and Customer Data Platforms mixed 39.4 - 1
AI Agent Tools (MCP servers, A2A agents) mixed 39.4 - 1

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

APIs 48

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

Customer.io Assets API

Manage file assets such as images and PDFs and organize them into folders.

Customer.io Data Index API

Update descriptions for attributes and events in your workspace. This helps improve AI-generated content and segments.

Customer.io ESP Suppression API

If you use Customer.io as your email service provider (ESP), these endpoints help you retrieve information about email addresses suppressed directly by the ESP. ESP-based suppre...

Customer.io Forms API

Connect forms to your workspace to identify people, apply form responses to people, and trigger campaigns for people who fill out forms on your website or in your app.

Customer.io Imports API

APIs to upload CSV files containing lists of people. These endpoints provide a convenient way to add and update people without having to make an `identify` call for each individ...

Customer.io Info API

Returns the list of addresses used by Customer.io. You must add add these addresses to your allowlist when using a custom SMTP provider and blocking unknown IP addresses.

Customer.io Live Notifications API

Start, update, and end live notifications—real-time activities on the iOS Lock Screen and Dynamic Island, and in the Android notification shade. Your server drives the activity'...

Customer.io Newsletter Metrics API

Newsletter metrics include metrics for translations, A/B tests, and links. These endpoints return information about newsletter metrics including metrics for translations and A/B...

Customer.io Newsletter Variants API

A newsletter variant is a translation or an A/B test. You can create, update, or delete variants in newsletters from these endpoints. You can also create a new A/B test group. I...

Customer.io Objects API

Objects are "groups" that you can relate people to in Customer.io—like the companies they work for, the online classes they take, and so on. These APIs help you find objects, th...

Customer.io Opt Outs API

The Opt-outs API from Customer.io — 2 operation(s) for opt-outs.

Customer.io Reporting Webhooks API

Set up webhooks to inform an external service about Customer.io events. Webhooks can notify you immediately when immediately when customer attributes change or when people open ...

Customer.io Send Messages API

Use these endpoints to send broadcasts or transactional messages to your audience. They use the same authentication method, but review the limits for both types of workflows to ...

Customer.io Subscription Center API

A subscription center differentiates the types of messages available for your product. Your audience sets subscription preferences by name, but we record subscription preference...

Customer.io Track Customers API

Add, modify, suppress, or unsuppress people (referred to as "customers" in our APIs). You can also use these endpoints to set attributes on people.

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 wh...

Customer.io Track Segments API

Manual segments are lists of people that you incorporate using the API or by uploading CSVs. You can add people to, or remove people from, manual segments with these endpoints. ...

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 yo...

Customer.io Track Region API

Determine whether your account and data are hosted in the US or EU data center using your [Track API Key](https://fly.customer.io/settings/api_credentials).

Customer.io Workspaces API

An API to retrieve information about your workspaces in your account. You can use this to look up counts for messages sent, monthly billable emails sent, people, and objects.

Customer.io Automations API

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, attribut...

Customer.io Components API

Custom components are reusable blocks of content that you build once and reference from any email. Use these endpoints to list, create, update, and delete custom components. Upd...

Customer.io Customer.io Journeys API Reference API

The Customer.io Journeys API Reference API from Customer.io — 0 operation(s) for customer.io journeys api reference.

Customer.io Email link and publish API

A Design Studio email doesn't send anything on its own. You [link](/integrations/api/design-studio/tag/email-email-link-and-publish/linkEmail/) it to a single workflow, like an ...

Customer.io Email testing API

Check an email before you publish or send it. - [Render](/integrations/api/design-studio/tag/email-testing/renderEmail/) returns the compiled HTML with liquid left intact. - [Pr...

Customer.io Emails API

Create and manage the emails you build in Design Studio, along with their translations and versions. - **Emails** hold the content, envelope details, and transformers for the de...

Customer.io Folders API

Folders organize your Design Studio files. Use these endpoints to list, create, rename, move, and delete folders. Folders hold emails, SMS, and components, but these endpoints r...

Customer.io SMS API

Create and manage the SMS messages you write in Design Studio. These endpoints only work if your workspace writes SMS in Design Studio. Workspaces that set up SMS on or after Ju...

Customer.io SMS link and publish API

A Design Studio SMS doesn't send anything on its own. After you [create](/integrations/api/design-studio/tag/sms/createSms/) an SMS, you [link](/integrations/api/design-studio/t...

Scroll for all 48

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

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Customer Io Rate Limits

4 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 — asyncapi rules

8 rules · 1 errors 7 warnings

SPECTRAL

Customer.io — jsonschema rules

6 rules · 5 warnings 1 info

SPECTRAL

Customer.io API Rules

6 rules · 3 errors 3 warnings

SPECTRAL

OpenAPI Overlays 44

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Customer Io Activities Api Phrasing Overlay

2 actions · phrasing · customer-io-activities-api-openapi.yml

GENERATED

Customer Io Alias Api Phrasing Overlay

2 actions · phrasing · customer-io-alias-api-openapi.yml

GENERATED

Customer Io App Api Overlay

3 actions · update · customer-io-app-api-openapi.json

GENERATED

Customer Io Assets Api Phrasing Overlay

11 actions · phrasing · customer-io-assets-api-openapi.yml

GENERATED

Customer Io Batch Api Phrasing Overlay

2 actions · phrasing · customer-io-batch-api-openapi.yml

GENERATED

Customer Io Broadcasts Api Phrasing Overlay

16 actions · phrasing · customer-io-broadcasts-api-openapi.yml

GENERATED

Customer Io Campaigns Api Phrasing Overlay

14 actions · phrasing · customer-io-campaigns-api-openapi.yml

GENERATED

Customer Io Collections Api Phrasing Overlay

8 actions · phrasing · customer-io-collections-api-openapi.yml

GENERATED

Customer Io Customers Api Phrasing Overlay

10 actions · phrasing · customer-io-customers-api-openapi.yml

GENERATED

Customer Io Data Index Api Phrasing Overlay

3 actions · phrasing · customer-io-data-index-api-openapi.yml

GENERATED

Customer Io Design Studio Api Phrasing Overlay

21 actions · phrasing · customer-io-design-studio-api-openapi.yml

GENERATED

Customer Io Esp Suppression Api Phrasing Overlay

6 actions · phrasing · customer-io-esp-suppression-api-openapi.yml

GENERATED

Customer Io Exports Api Phrasing Overlay

6 actions · phrasing · customer-io-exports-api-openapi.yml

GENERATED

Customer Io Forms Api Phrasing Overlay

2 actions · phrasing · customer-io-forms-api-openapi.yml

GENERATED

Customer Io Group Api Phrasing Overlay

2 actions · phrasing · customer-io-group-api-openapi.yml

GENERATED

Customer Io Identify Api Phrasing Overlay

2 actions · phrasing · customer-io-identify-api-openapi.yml

GENERATED

Customer Io Imports Api Phrasing Overlay

3 actions · phrasing · customer-io-imports-api-openapi.yml

GENERATED

Customer Io Info Api Phrasing Overlay

2 actions · phrasing · customer-io-info-api-openapi.yml

GENERATED

Customer Io Live Notifications Api Phrasing Overlay

5 actions · phrasing · customer-io-live-notifications-api-openapi.yml

GENERATED

Customer Io Messages Api Phrasing Overlay

4 actions · phrasing · customer-io-messages-api-openapi.yml

GENERATED

Customer Io Newsletter Metrics Api Phrasing Overlay

6 actions · phrasing · customer-io-newsletter-metrics-api-openapi.yml

GENERATED

Customer Io Newsletter Variants Api Phrasing Overlay

14 actions · phrasing · customer-io-newsletter-variants-api-openapi.yml

GENERATED

Customer Io Newsletters Api Phrasing Overlay

5 actions · phrasing · customer-io-newsletters-api-openapi.yml

GENERATED

Customer Io Objects Api Phrasing Overlay

5 actions · phrasing · customer-io-objects-api-openapi.yml

GENERATED

Customer Io Opt Outs Api Phrasing Overlay

4 actions · phrasing · customer-io-opt-outs-api-openapi.yml

GENERATED

Customer Io Page Api Phrasing Overlay

2 actions · phrasing · customer-io-page-api-openapi.yml

GENERATED

Customer Io Pipelines Api Overlay

3 actions · update · customer-io-pipelines-api-openapi.json

GENERATED

Customer Io Reporting Webhooks Api Phrasing Overlay

6 actions · phrasing · customer-io-reporting-webhooks-api-openapi.yml

GENERATED

Customer Io Reporting Webhooks Overlay

3 actions · update · customer-io-reporting-webhooks-openapi.json

GENERATED

Customer Io Screen Api Phrasing Overlay

2 actions · phrasing · customer-io-screen-api-openapi.yml

GENERATED

Customer Io Segments Api Phrasing Overlay

8 actions · phrasing · customer-io-segments-api-openapi.yml

GENERATED

Customer Io Send Messages Api Phrasing Overlay

9 actions · phrasing · customer-io-send-messages-api-openapi.yml

GENERATED

Customer Io Sender Identities Api Phrasing Overlay

4 actions · phrasing · customer-io-sender-identities-api-openapi.yml

GENERATED

Customer Io Snippets Api Phrasing Overlay

5 actions · phrasing · customer-io-snippets-api-openapi.yml

GENERATED

Customer Io Subscription Center Api Phrasing Overlay

4 actions · phrasing · customer-io-subscription-center-api-openapi.yml

GENERATED

Customer Io Track Api Overlay

3 actions · update · customer-io-track-api-openapi.json

GENERATED

Customer Io Track Api Phrasing Overlay

2 actions · phrasing · customer-io-track-api-openapi.yml

GENERATED

Customer Io Track Customers Api Phrasing Overlay

9 actions · phrasing · customer-io-track-customers-api-openapi.yml

GENERATED

Customer Io Track Events Api Phrasing Overlay

5 actions · phrasing · customer-io-track-events-api-openapi.yml

GENERATED

Customer Io Track Segments Api Phrasing Overlay

3 actions · phrasing · customer-io-track-segments-api-openapi.yml

GENERATED

Customer Io Track V2 Api Phrasing Overlay

3 actions · phrasing · customer-io-track-v2-api-openapi.yml

GENERATED

Customer Io Trackregion Api Phrasing Overlay

2 actions · phrasing · customer-io-trackregion-api-openapi.yml

GENERATED

Customer Io Transactional Api Phrasing Overlay

10 actions · phrasing · customer-io-transactional-api-openapi.yml

GENERATED

Customer Io Workspaces Api Phrasing Overlay

2 actions · phrasing · customer-io-workspaces-api-openapi.yml

GENERATED

Scroll for all 44

JSON Schema 43

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

activityObject

10 properties

JSON SCHEMA

alias

3 properties

JSON SCHEMA

anonymousEventsRequest

0 properties

JSON SCHEMA

anonymous_id

0 properties

JSON SCHEMA

batch

3 properties

JSON SCHEMA

campaignObject

0 properties

JSON SCHEMA

campaignRequest

0 properties

JSON SCHEMA

cio_id

0 properties

JSON SCHEMA

Email

0 properties

JSON SCHEMA

In-App

0 properties

JSON SCHEMA

Inbox message

0 properties

JSON SCHEMA

Push

0 properties

JSON SCHEMA

SMS

0 properties

JSON SCHEMA

Webhook

0 properties

JSON SCHEMA

customer_id

0 properties

JSON SCHEMA

Customer.io Customer

8 properties

JSON SCHEMA

Delivery: Event

5 properties

JSON SCHEMA

device_object

0 properties

JSON SCHEMA

email_address

0 properties

JSON SCHEMA

Customer.io Event

7 properties

JSON SCHEMA

eventsRequest

0 properties

JSON SCHEMA

group

0 properties

JSON SCHEMA

Person: Identify

0 properties

JSON SCHEMA

identify

0 properties

JSON SCHEMA

newsletterObject

18 properties

JSON SCHEMA

not_nullable_customer_id

0 properties

JSON SCHEMA

not_nullable_email_address

0 properties

JSON SCHEMA

page

0 properties

JSON SCHEMA

Person: Event

0 properties

JSON SCHEMA

Person: Merge

4 properties

JSON SCHEMA

Person: Page view

0 properties

JSON SCHEMA

Person: Screen view

0 properties

JSON SCHEMA

screen

0 properties

JSON SCHEMA

track-metrics

2 properties

JSON SCHEMA

track

0 properties

JSON SCHEMA

Transformers

8 properties

JSON SCHEMA

Email

0 properties

JSON SCHEMA

Inbox message

0 properties

JSON SCHEMA

Push

0 properties

JSON SCHEMA

SMS

0 properties

JSON SCHEMA

Webhook

0 properties

JSON SCHEMA

v1_cio_relationships

2 properties

JSON SCHEMA

Customer.io Reporting Webhook Payload

4 properties

JSON SCHEMA

Scroll for all 43

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

no policy recorded

SECURITY

Customer Io Trust Center

SOC 2, ISO 27001, HIPAA, GDPR

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Customer Io Scopes

5 scopes

5 scopes

SCOPES

Agentic Access 1

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

Customer Io Agentic Access

191 operations · 89 acting

191 operations · 89 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 13

Pagination, idempotency, versioning, errors, and events

Scroll for all 13

Build 6

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 6

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 8

Properties that don't map to a standard resource type

Scroll for all 8

Source (apis.yml)

apis.yml Raw ↑
aid: customer-io
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
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
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.23'
created: '2024-01-01'
modified: '2026-09-16'
name: Customer.io
tags:
- Behavioral Data
- Broadcast
- Campaigns
- CDP
- Customer Data
- Customer Data Platform
- Data Ingestion
- Email
- Event Tracking
- Marketing Automation
- Messaging
- Push Notifications
- Segments
- SMS
- Transactional Email
- A2A
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.
common:
- type: Spectral
  url: rules/customer-io-rules.yml
- type: Spectral
  url: rules/customer-io-jsonschema-spectral-rules.yml
- type: Spectral
  url: rules/customer-io-asyncapi-spectral-rules.yml
- type: Webhooks
  url: asyncapi/customer-io-reporting-webhooks-asyncapi.yml
- type: Deprecation
  url: lifecycle/customer-io-lifecycle.yml
- type: Hosts
  url: hosts/customer-io-hosts.yml
- type: IntegrationEdges
  url: integrations/customer-io-integration-edges.yml
- type: Vendors
  url: vendors/customer-io-vendors.yml
- type: CapabilityMap
  url: capabilities/customer-io-capability-edges.yml
  name: Customer.io Business Capability Map
- type: Overlay
  url: overlays/customer-io-pipelines-api-overlay.yaml
- type: Overlay
  url: overlays/customer-io-reporting-webhooks-overlay.yaml
- 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
- type: Contact
  url: mailto:press@customer.io
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
  - type: JSONSchema
    url: json-schema/customer-io-track-schema.json
  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/
  - type: JSONSchema
    url: json-schema/customer-io-alias-schema.json
- 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/
  - type: JSONSchema
    url: json-schema/customer-io-batch-schema.json
- 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:
  - Broadcast
  tags_raw:
  - 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-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-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/
  - type: JSONSchema
    url: json-schema/customer-io-group-schema.json
- 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/
  - type: JSONSchema
    url: json-schema/customer-io-identify-schema.json
- 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/
  - type: JSONSchema
    url: json-schema/customer-io-create-email-newsletter-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-create-inbox-newsletter-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-create-webhook-newsletter-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-create-push-newsletter-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-create-in-app-newsletter-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-create-sms-newsletter-schema.json
- 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/
  - type: JSONSchema
    url: json-schema/customer-io-page-schema.json
- 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/
  - type: JSONSchema
    url: json-schema/customer-io-screen-schema.json
- 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: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/
- aid: customer-io:customer-io-assets-api
  name: Customer.io Assets API
  description: Manage file assets such as images and PDFs and organize them into folders.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Assets
  properties:
  - type: OpenAPI
    url: openapi/customer-io-assets-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-data-index-api
  name: Customer.io Data Index API
  description: Update descriptions for attributes and events in your workspace. This helps improve AI-generated content and
    segments.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Data Index
  properties:
  - type: OpenAPI
    url: openapi/customer-io-data-index-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-esp-suppression-api
  name: Customer.io ESP Suppression API
  description: 'If you use Customer.io as your email service provider (ESP), these endpoints help you retrieve information
    about email addresses suppressed directly by the ESP. ESP-based suppressions are different from suppression in Customer.io:
    these are addresses that the ESP suppressed automatically because a message bounced, a customer requested they not be
    contacted again, etc. These are _not_ addresses that you deleted and suppressed either in our UI or through [the API](#operation/suppress).'
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - ESP Suppression
  properties:
  - type: OpenAPI
    url: openapi/customer-io-esp-suppression-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-forms-api
  name: Customer.io Forms API
  description: Connect forms to your workspace to identify people, apply form responses to people, and trigger campaigns for
    people who fill out forms on your website or in your app.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Forms
  properties:
  - type: OpenAPI
    url: openapi/customer-io-forms-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/
  - type: JSONSchema
    url: json-schema/customer-io-customer-id-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-email-address-schema.json
- aid: customer-io:customer-io-imports-api
  name: Customer.io Imports API
  description: APIs to upload CSV files containing lists of people. These endpoints provide a convenient way to add and update
    people without having to make an `identify` call for each individual person.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Import
  tags_raw:
  - Imports
  properties:
  - type: OpenAPI
    url: openapi/customer-io-imports-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-info-api
  name: Customer.io Info API
  description: Returns the list of addresses used by Customer.io. You must add add these addresses to your allowlist when
    using a custom SMTP provider and blocking unknown IP addresses.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Info
  properties:
  - type: OpenAPI
    url: openapi/customer-io-info-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-live-notifications-api
  name: Customer.io Live Notifications API
  description: Start, update, and end live notifications—real-time activities on the iOS Lock Screen and Dynamic Island, and
    in the Android notification shade. Your server drives the activity's content; Customer.io handles token lookup and push
    delivery.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Live Notifications
  properties:
  - type: OpenAPI
    url: openapi/customer-io-live-notifications-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-newsletter-metrics-api
  name: Customer.io Newsletter Metrics API
  description: 'Newsletter metrics include metrics for translations, A/B tests, and links.


    These endpoints return information about newsletter metrics including metrics for translations and A/B tests. You can
    update variants in newsletters from these endpoints, but you must perform all other create, update, and/or delete operations
    through the UI.'
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Newsletter Metrics
  properties:
  - type: OpenAPI
    url: openapi/customer-io-newsletter-metrics-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-newsletter-variants-api
  name: Customer.io Newsletter Variants API
  description: 'A newsletter variant is a translation or an A/B test. You can create, update, or delete variants in newsletters
    from these endpoints. You can also create a new A/B test group.


    If your newsletters include assets like images or PDFs, host them in your [workspace''s assets](/integrations/api/app/#tag/assets)
    or at another public URL, and include the URL in your message content.'
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Newsletter Variants
  properties:
  - type: OpenAPI
    url: openapi/customer-io-newsletter-variants-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/
  - type: JSONSchema
    url: json-schema/customer-io-update-email-content-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-update-inbox-content-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-update-webhook-content-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-update-push-content-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-update-sms-content-schema.json
- aid: customer-io:customer-io-objects-api
  name: Customer.io Objects API
  description: Objects are "groups" that you can relate people to in Customer.io—like the companies they work for, the online
    classes they take, and so on. These APIs help you find objects, their attributes, the people they're related to, etc.
    Use the [track API v1](/api/track/#tag/Track-Customers) or the [Track v2 API](/api/track/#tag/track_v2) to add and relate
    people to objects to your workspace and assign their attributes.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Objects
  properties:
  - type: OpenAPI
    url: openapi/customer-io-objects-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-opt-outs-api
  name: Customer.io Opt Outs API
  description: The Opt-outs API from Customer.io — 2 operation(s) for opt-outs.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Opt-Outs
  tags_raw:
  - Opt-outs
  properties:
  - type: OpenAPI
    url: openapi/customer-io-opt-outs-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-reporting-webhooks-api
  name: Customer.io Reporting Webhooks API
  description: Set up webhooks to inform an external service about Customer.io events. Webhooks can notify you immediately
    when immediately when customer attributes change or when people open your messages.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Reporting Webhooks
  properties:
  - type: OpenAPI
    url: openapi/customer-io-reporting-webhooks-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-send-messages-api
  name: Customer.io Send Messages API
  description: 'Use these endpoints to send broadcasts or transactional messages to your audience. They use the same authentication
    method, but review the limits for both types of workflows to make sure you''ll successfully trigger your messages.


    You can''t trigger campaigns through our APIs.


    ## API triggered broadcast limits


    While [API triggered broadcasts](#operation/triggerBroadcast) are limited to 1 request every 10 seconds, they''re also
    limited by the number of triggers you can have queued at a time, as shown in the table below.


    | Data Type | Limit | Description |

    | -- | -- | -- |

    | Trigger Payload | 25MB | Max length of the entire Trigger call, larger calls are typically to support `per_user_data`
    |

    | Trigger Data | 50000 bytes | Max length of the data section in the Trigger call |

    | Recipient List<sup>1</sup> | 10000 recipients | Max number of ids or emails included in the Trigger call |

    | Custom Per User Data<sup>1</sup> | 10000 entries | Max number of entries in `per_user_data` |

    | Custom Per User Data<sup>1</sup> | 2MB | Max length per user in the file referenced by `data_file_url`. |

    | Custom Per User Data<sup>1</sup> | 10GB | Max length of the entire size of the file referenced by `data_file_url` |

    | Trigger Queue | 5 triggers | Max number of triggers waiting to be processed consecutively |


    <sup>1</sup>For larger data sets, use `data_file_url` to supply a link to a file that contains your merge data. Attempting
    to send too much data in a single API call will fail.


    ## Transactional Message Limits


    The `/send-*` endpoints are limited to 100 requests per second.


    | Data Type | Limit | Description |

    | -- | -- | -- |

    | Payload | 1MB | Max length of the payload, excepting attachments |

    | Attachments (email) | 2MB | Maximum size of attachments |

    | Recipients | 15 | Total number of recipients across the `to`, `cc`, and `bcc` fields. |'
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Send Messages
  properties:
  - type: OpenAPI
    url: openapi/customer-io-send-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-subscription-center-api
  name: Customer.io Subscription Center API
  description: A subscription center differentiates the types of messages available for your product. Your audience sets subscription
    preferences by name, but we record subscription preferences by topic ID. You can use these endpoints to get a list of
    topics and names, helping you understand your audience's subscription preferences.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Subscription Center
  properties:
  - type: OpenAPI
    url: openapi/customer-io-subscription-center-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-track-customers-api
  name: Customer.io Track Customers API
  description: Add, modify, suppress, or unsuppress people (referred to as "customers" in our APIs). You can also use these
    endpoints to set attributes on people.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:
  - Track Customers
  properties:
  - type: OpenAPI
    url: openapi/customer-io-track-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/
  - type: JSONSchema
    url: json-schema/customer-io-v1-cio-relationships-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-device-object-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-anonymous-id-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-cio-id-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-not-nullable-customer-id-schema.json
  - type: JSONSchema
    url: json-schema/customer-io-not-nullable-email-address-schema.json
- aid: customer-io:customer-io-track-events-api
  name: Customer.io Track Events API
  description: 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.
  humanURL: https://docs.customer.io/integrations/api/track/
  baseURL: https://track.customer.io
  tags:


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

Work with this as data

Every provider 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 providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • 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 provider
curl "https://apis.io/api/v1/providers/customer-io"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/customer-io/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/customer-io/evidence"

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.

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