Customer.io

Customer.io is a customer messaging platform; this Arcade toolkit lets LLM agents read and write Customer.io workspace data — profiles, events, campaigns, segments, and transactional messages — via the Customer.io App API and Tracking API.

Capabilities

• Profile management: Create, update, look up, and delete person records; resolve people by email or ID, handling multi-match scenarios.
• Event & activity tracking: Record custom events on a person's timeline and inspect their activity history, filtered by type or name.
• Messaging history & delivery: Retrieve per-person message and delivery history; read aggregate delivery metrics for campaigns and newsletters.
• Segment & audience tools: List all workspace segments, enumerate members of a segment, look up which segments a person belongs to, and search for people by segment membership and/or attribute.
• Campaign & content discovery: List campaigns, newsletters, broadcasts, and transactional message templates; read campaign/newsletter metrics; trigger API broadcasts and send transactional emails.

Secrets

All credentials must be configured as Arcade secrets. This toolkit requires four secrets:

• CUSTOMERIO_APP_API_KEY — A Customer.io App API key, used for read and write operations against the App API (profiles, segments, campaigns, metrics, etc.). Generate one in your Customer.io workspace under Settings → API Credentials → App API Keys. Keys can be scoped; ensure the key has permissions matching the operations you intend to perform (read and/or write access to people, campaigns, segments, and messages).

• CUSTOMERIO_TRACKING_API_KEY — A Customer.io Tracking API key (also called the API Key in the Tracking section), used for event tracking and person identification via the Track API. Retrieve it from Settings → API Credentials — it is paired with the Site ID.

• CUSTOMERIO_SITE_ID — The Site ID associated with your Customer.io workspace, required for Tracking API authentication alongside the Tracking API key. Found in Settings → API Credentials next to the Tracking API key.

• CUSTOMERIO_REGION — Identifies which Customer.io data center hosts your workspace (us or eu). Determines the API base URL used for all requests. Find your region in Settings → Account Settings or by checking which URL you use to log in (fly.customer.io = EU, app.customer.io = US).

See the Arcade docs for how to configure secrets: https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets — or manage them directly at https://api.arcade.dev/dashboard/auth/secrets.