Customer.io Connection

Connects your agent to Customer.io for lifecycle messaging across email, push, SMS, and in-app. Read campaigns and segments, look up people, and trigger transactional sends.

Authentication

App API key (distinct from the Track API key — App is for messaging/data reads).

• CUSTOMERIO_APP_API_KEY — App API key, sent as Bearer
• CUSTOMERIO_REGION — us (default) or eu — picks api.customer.io vs api-eu.customer.io

Endpoints

People

• GET /v1/customers/{id} — Person attributes and segment membership
• GET /v1/segments/{id}/membership — People in a segment
• POST /v1/customers/{id} — Update attributes (requires confirmation for bulk)

Segments & campaigns

• GET /v1/segments — All segments
• GET /v1/campaigns — All campaigns
• GET /v1/campaigns/{id}/metrics — Send/open/click metrics

Sending

• POST /v1/send/email — Transactional email send
• POST /v1/send/push — Transactional push
• POST /v1/send/sms — Transactional SMS

Broadcasts

• GET /v1/broadcasts — Broadcast list
• POST /v1/campaigns/{id}/triggers — Trigger a broadcast (requires confirmation)

Rules

• Rate limit: 100 requests/second on App API
• Person/customer emails are PII — always redact in logs
• Triggering broadcasts can reach thousands of recipients — always confirm