Customer.io
Arcade.dev LLM tools for Customer.io
0.1.0Customer.io is a customer messaging platform for behavioral email, push, and SMS campaigns. This Arcade toolkit enables LLMs to manage contacts, query campaign and newsletter metrics, drive lifecycle journeys via events, and send transactional and broadcast messages — all against the Customer.io API.
Capabilities
- Contact management: Look up, create, update, delete, and search people by email, ID, or segment/attribute filters; inspect a person's activity timeline, message history, and segment memberships.
- Segment & audience introspection: List all workspace segments, enumerate members of a segment, and combine segment and attribute filters to build targeted audiences.
- Campaign & newsletter analytics: Retrieve aggregate delivery metrics for campaigns and newsletters over configurable time periods; list all campaigns and newsletters to discover their IDs.
- Event & journey triggering: Record named custom events on a person's timeline to advance lifecycle journeys; trigger API broadcasts to segments or explicit recipient lists.
- Transactional & broadcast messaging: List transactional message templates and send a transactional email to a single recipient by template ID; list and trigger broadcasts.
Secrets
This toolkit requires no OAuth flow but uses four secrets that must be configured explicitly.
-
CUSTOMERIO_APP_API_KEY— A Customer.io App API key, used for the App API (beta/data endpoints such as people search, segment membership, campaign metrics, and message delivery history). 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— The Tracking API key for your workspace, used for write operations against the Track API (identify, event recording, etc.). Found in the Customer.io dashboard under Settings → API Credentials → Tracking API Keys. Each workspace has a paired Site ID and Tracking API key. -
CUSTOMERIO_SITE_ID— The workspace Site ID that pairs withCUSTOMERIO_TRACKING_API_KEYfor Tracking API authentication. Located in the same Settings → API Credentials section of the dashboard. -
CUSTOMERIO_REGION— Identifies the Customer.io data region for your workspace (usoreu). This determines which base URL the toolkit uses (e.g.,api.customer.iovseu-api.customer.io). Find your region in the Customer.io dashboard under Settings → Workspace Settings.
Configure these secrets in the Arcade secret store. See the Arcade secrets guide for setup instructions, or manage them directly at https://api.arcade.dev/dashboard/auth/secrets.
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 |