Customer.io

Customer.io is a customer engagement platform for behavioral messaging and lifecycle automation. This Arcade toolkit exposes Customer.io's App API and Tracking API as LLM-callable tools, covering people management, event tracking, segmentation, messaging, and campaign analytics.

Capabilities

• People & profile management — create, update, look up, and delete person records; resolve by email or ID; handle multi-match scenarios.
• Event & activity tracking — record custom named events on a person's timeline; list a person's recent activities filtered by type and/or name.
• Segments & audience discovery — list workspace segments, inspect segment members, find which segments a person belongs to, and search for people by segment membership and/or attribute.
• Messaging history & transactional email — retrieve a person's full message/delivery history; list and send transactional email templates to individual recipients.
• Broadcasts — list available API broadcasts and trigger them against a segment or an explicit recipient list.
• Campaign & newsletter analytics — read aggregate delivery metrics for campaigns and newsletters over configurable time periods.

Secrets

All four secrets below are required for full toolkit functionality. Set them via the Arcade secrets dashboard or the Arcade config, following the tool secrets guide.

• CUSTOMERIO_APP_API_KEY — An App API key used to authenticate requests to Customer.io's App API (reporting, segmentation, people lookup, broadcasts, campaigns, newsletters, transactional messages). Generate one in your Customer.io workspace under Settings → API Credentials → App API Keys. The key requires access to the data/features you intend to use; workspace Admin or appropriate role is typically required. See Customer.io App API authentication docs.

• CUSTOMERIO_TRACKING_API_KEY — A Tracking API key (also called the API Secret) used to authenticate requests to Customer.io's Tracking API (identifying people, recording events). Found in Settings → API Credentials alongside your Site ID. See Customer.io Tracking API authentication docs.

• CUSTOMERIO_SITE_ID — The Site ID paired with the Tracking API key to form the basic-auth credentials for Tracking API requests. Also found in Settings → API Credentials in your workspace dashboard.

• CUSTOMERIO_REGION — Designates which Customer.io data center your workspace is hosted on (us or eu). This controls which base URLs the toolkit calls. Find your region in Settings → API Credentials or in your workspace URL (e.g., fly.customer.io indicates the EU region). See Customer.io regional endpoints documentation.