Customer.io
Arcade.dev LLM tools for Customer.io
0.1.0Customer.io is a customer engagement platform for behavioral email, push, and SMS campaigns. This Arcade toolkit lets LLMs read and write Customer.io workspace data — profiles, events, segments, campaigns, and messages — using the Customer.io App and Tracking APIs.
Capabilities
- Profile management: create, update, look up, and delete person records; resolve by email or ID; handle multi-match scenarios.
- Event and journey tracking: record custom named events on a person's timeline to trigger lifecycle automations.
- Audience and segment operations: list workspace segments, inspect segment membership, search people by segment and/or attribute filters.
- Campaign and newsletter insights: list campaigns and newsletters; retrieve aggregate delivery metrics for each over configurable periods.
- Broadcast and transactional messaging: list broadcasts and trigger API broadcasts to segments or explicit recipient lists; list transactional templates and send transactional emails by template ID.
- Activity and message history: retrieve a person's recent activities (filterable by type and name) and full message/delivery history.
Secrets
This toolkit requires no OAuth flow; all authentication is handled via secrets passed at runtime.
CUSTOMERIO_APP_API_KEY
A Customer.io App API key, used to call the Beta App API (profile lookups, segment queries, metrics, etc.). Generate one in the Customer.io dashboard under Settings → API Credentials → App API Keys. The key requires the permissions appropriate to the operations you intend to perform (read and/or write access to contacts, segments, campaigns).
CUSTOMERIO_TRACKING_API_KEY
The Tracking API key for your workspace, used to identify/update people and record events via the Track API. Found in the Customer.io dashboard under Settings → API Credentials → Tracking API Keys. It is paired with the Site ID below.
CUSTOMERIO_SITE_ID
Your workspace's Site ID, required alongside the Tracking API key to authenticate Track API calls. Located in Settings → API Credentials next to the Tracking API key.
CUSTOMERIO_REGION
Indicates which Customer.io data center hosts your workspace: us (default) or eu. This determines the API base URLs the toolkit calls. Find your region in Settings → Workspace Settings or from the URL you use to log in to Customer.io.
For guidance on configuring secrets in Arcade, see the Arcade secrets docs. You can also manage secrets 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 |