Customer.io
Arcade.dev LLM tools for Customer.io
1.0.0Customer.io is a customer engagement platform for behavioral messaging. This Arcade toolkit lets LLMs read and write Customer.io workspace data — people, events, campaigns, segments, and transactional messages — using the Customer.io App API and Tracking API.
Capabilities
- People management — create or update person profiles with arbitrary attributes, look up people by email or ID, list a person's activities, messages, and segment memberships, and delete person records for data-removal compliance.
- Audience & segmentation — list all workspace segments, enumerate members of a specific segment, and search people by segment membership and/or attribute values to build audiences without known IDs.
- Campaign & newsletter analytics — list campaigns and newsletters, and retrieve aggregate delivery metrics (e.g., sent, opened, clicked) for each over a chosen time period.
- Event tracking — record named custom events on a person's timeline to trigger lifecycle journeys and behavioral workflows.
- Broadcasts & transactional messaging — list API-triggered broadcasts and trigger them against a segment or an explicit recipient list; list transactional templates and send a transactional email to a single recipient by template ID.
Secrets
This toolkit requires no OAuth flow; all authentication is handled via secrets injected at runtime.
CUSTOMERIO_APP_API_KEY
A Customer.io App API Key used to call the App API (data reads, campaign/segment operations, metrics). Generate one in the Customer.io dashboard under Settings → API Credentials → App API Keys. The key is shown only at creation time, so copy it immediately.
CUSTOMERIO_TRACKING_API_KEY
A Customer.io Tracking API Key (sometimes called a Tracking Site API Key) used to identify people and record events via the Track API. Find or rotate it in the Customer.io dashboard under Settings → API Credentials → Tracking API Keys alongside the Site ID below.
CUSTOMERIO_SITE_ID
The workspace's Site ID, paired with CUSTOMERIO_TRACKING_API_KEY for Tracking API basic-auth calls. It is displayed in the same Settings → API Credentials section of the Customer.io dashboard.
CUSTOMERIO_REGION
The data region for your Customer.io workspace — typically us or eu. This controls which base URL the toolkit routes requests to (track.customer.io vs cdp.customer.io EU endpoints). Find your workspace region in the Customer.io dashboard under Settings → Workspace Settings.
Store all secrets using the Arcade secrets guide or the Arcade dashboard.
Available tools(18)
| Tool name | Description | Secrets | |
|---|---|---|---|
Delete a person record to honor a data-removal request.
Deleting a person who does not exist is accepted as a no-op. | 2 | ||
Read a campaign's aggregate delivery metrics over a period. | 2 | ||
Read a newsletter's aggregate delivery metrics over a period. | 2 | ||
Look up a person's profile by email or id.
Resolves the person by whichever identifier is supplied; an email shared by
several people reports every match in the result. | 2 | ||
Create or update a person and their attributes.
Existing attributes not named in this call are preserved; named attributes
are added or overwritten. | 2 | ||
List the workspace's broadcasts to discover ids that can be triggered. | 2 | ||
List the campaigns in the workspace. | 2 | ||
List the newsletters in the workspace. | 2 | ||
List a person's recent activities, most recent first, resolved by email
or id. Optionally filter by activity type and/or name; filtering by name
requires an activity type. When an email matches several people, the first
match's activities are returned. | 2 | ||
List a person's message and delivery history, most recent first,
resolved by email or id. When an email matches several people, the first
match's messages are returned. | 2 | ||
List the segments a person belongs to, resolved by email or id. When an
email matches several people, the first match's segments are returned. | 2 | ||
List the ids of the people in a segment and the segment's total size. | 2 | ||
List the segments defined in the workspace. | 2 | ||
List the transactional message templates in the workspace. | 2 | ||
Record a named custom event on a person's timeline to drive lifecycle
journeys. | 2 | ||
Find people by segment membership and/or an attribute, to build an
audience without a known id. Supply at least one of a segment or an
attribute name; both combine with AND. | 2 | ||
Send a transactional email to one recipient by its template id. | 2 | ||
Trigger an API broadcast to a segment or an explicit recipient list. | 2 |