Customer.io
Arcade.dev LLM tools for Customer.io
3.0.1Customer.io is a customer engagement platform for sending lifecycle, broadcast, newsletter, and transactional messages. This Arcade toolkit exposes tools for managing people, segments, campaigns, and messaging across a Customer.io workspace.
Capabilities
- People management — look up, create, update, and delete person profiles; record custom events on a person's timeline to drive lifecycle journeys.
- Audience & segmentation — list all workspace segments, query segment membership, find people by segment and/or attribute, and list the segments a specific person belongs to.
- Activity & message history — retrieve a person's recent activities (filterable by type and name) and their full message/delivery history.
- Campaigns, newsletters & broadcasts — list campaigns, newsletters, and broadcasts; read aggregate delivery metrics for campaigns and newsletters; trigger API broadcasts to a segment or an explicit recipient list.
- Transactional messaging — list transactional message templates and send a transactional email to a single recipient by template ID.
Secrets
All secrets are supplied as environment-level configuration. No OAuth flow is involved.
-
CUSTOMERIO_APP_API_KEY— A Customer.io App API key, used for the App API (people lookup, segments, campaigns, metrics, etc.). Generate one in the Customer.io dashboard under Settings → API Credentials → App API Keys. The key requires appropriate workspace permissions; account owner or admin access is typically needed to create keys. -
CUSTOMERIO_TRACKING_API_KEY— A Customer.io Tracking API key (also called the API Key in the track credentials section), used for the Track API (creating/updating people, recording events). Found in the Customer.io dashboard under Settings → API Credentials → Tracking API Keys alongside the Site ID. -
CUSTOMERIO_SITE_ID— The Site ID paired with the Tracking API key for your Customer.io workspace. Located in the same Settings → API Credentials → Tracking API Keys screen as the Tracking API key. Required to authenticate Track API calls. -
CUSTOMERIO_REGION— The data region your Customer.io workspace is hosted in (e.g.,usoreu). Determines which API base URLs are used. Find your region in the Customer.io dashboard under Settings → Workspace Settings; it matches the subdomain you log in through (fly.customer.iofor US,fly.eu.customer.iofor EU).
For instructions on storing secrets in Arcade, see Create Tool Secrets. You can manage your secrets at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(18)
| Tool name | Description | Secrets | |
|---|---|---|---|
Read a campaign's aggregate delivery metrics over a period. | 2 | ||
Read a newsletter's aggregate delivery metrics over a period. | 2 | ||
Record a named custom event on a person's timeline to drive lifecycle
journeys. | 2 | ||
Delete a person record to honor a data-removal request.
Deleting a person who does not exist is accepted as a no-op. | 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 | ||
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 | ||
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 | ||
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 | ||
Create or update a person and their attributes.
Existing attributes not named in this call are preserved; named attributes
are added or overwritten. | 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 |