Customer.io

Customer.io Toolkit

The Customer.io toolkit gives Arcade-powered LLMs direct access to Customer.io workspaces, enabling automation of customer data management, messaging, segmentation, and analytics.

Capabilities

• Person lifecycle management — create, update, look up, search, and delete person records; record custom events to drive journey triggers.
• Messaging & delivery — send transactional emails by template, trigger API broadcasts to segments or explicit recipient lists, and retrieve full message/delivery history per person.
• Campaigns, newsletters & broadcasts — list all campaigns, newsletters, and broadcasts in the workspace; read aggregate delivery metrics for campaigns and newsletters over configurable periods.
• Segmentation — list workspace segments, inspect segment membership, list segments a person belongs to, and search people by segment and/or attribute.
• Activity & audit — page through a person's activity timeline with optional filtering by type and name; page through per-person message history.

Secrets

All four secrets are required for full toolkit functionality. Configure them in the Arcade secrets dashboard and reference the Arcade secrets guide.

• CUSTOMERIO_APP_API_KEY — A Customer.io App API key, used for all Beta/App API calls (person lookup, segmentation, metrics, etc.). Generate one in your Customer.io workspace under Settings → API Credentials → App API Keys. Select the appropriate permission scopes for the operations you need (e.g., customers:read, customers:write, campaigns:read). See the Customer.io App API key docs.

• CUSTOMERIO_TRACKING_API_KEY — A Customer.io Tracking API key (the secret portion of the site credentials pair), used for write operations against the Track API such as identifying people and recording events. Found in Settings → API Credentials → Tracking API Keys alongside the Site ID. See the Customer.io Tracking API credentials docs.

• CUSTOMERIO_SITE_ID — The Site ID that pairs with the Tracking API key to authenticate Track API requests. Retrieved from the same Settings → API Credentials → Tracking API Keys page as the Tracking API key.

• CUSTOMERIO_REGION — The data region for your Customer.io workspace. Accepted values are us (default, track.customer.io) or eu (cdp.customer.io). Find your region in Settings → Workspace Settings. Using the wrong region causes all API calls to fail silently or return 404s. See the Customer.io regional endpoint docs.