Customer.io
Arcade.dev LLM tools for Customer.io
0.1.0Customer.io is a customer engagement platform for behavioral email, push, and messaging automation. This Arcade toolkit exposes Customer.io's App API and Tracking API as LLM-callable tools, enabling agents to manage contacts, query analytics, and drive messaging workflows.
Capabilities
- Contact management: Create, update, look up, and delete person records; search people by segment or attribute; resolve contacts by email or ID.
- Activity & message history: Retrieve a person's event timeline, delivery history, and segment memberships.
- Segment & audience operations: List workspace segments, inspect segment members, and build audiences for broadcasts.
- Campaign & newsletter analytics: Read aggregate delivery metrics for campaigns and newsletters; list all campaigns and newsletters in the workspace.
- Transactional & broadcast messaging: List transactional templates, send transactional emails by template ID, list broadcasts, and trigger API broadcasts to segments or explicit recipient lists.
- Custom event tracking: Record named events on a person's timeline to drive lifecycle journeys and automation.
Secrets
All credentials are injected as Arcade secrets. No OAuth flow is involved.
-
CUSTOMERIO_APP_API_KEY— A Customer.io App API key, used for read/write operations against the App API (people, segments, campaigns, metrics, broadcasts, transactional messages). Generate one in the Customer.io dashboard under Settings → API Credentials → App API Keys. The key requires appropriate permissions for the operations your agent will perform (e.g., reporting access for metrics, messaging access for sends). See the Customer.io App API authentication docs. -
CUSTOMERIO_TRACKING_API_KEY— A Customer.io Tracking API key (also called a Site API Key), used to identify/create/update people and record events via the Tracking API. Found in Settings → API Credentials alongside the Site ID. See the Customer.io Tracking API authentication docs. -
CUSTOMERIO_SITE_ID— The workspace Site ID, required alongside the Tracking API key to authenticate Tracking API requests. Retrieved from Settings → API Credentials in the Customer.io dashboard. -
CUSTOMERIO_REGION— Specifies the Customer.io data region for your workspace (usoreu). This controls which API base URL is used. Find your region in Settings → Account Settings or by checking which regional endpoint your workspace was provisioned on.
For guidance on storing and referencing secrets in Arcade, see the Arcade secrets docs. Secrets can be managed 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 |