Composio HQ Customer.io Automation
Automate customer engagement operations -- trigger targeted broadcasts, retrieve delivery metrics, manage audience segments, list newsletters and transactional templates, and inspect trigger execution history -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/customerio
Setup
- Connect your Customer.io account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
CUSTOMERIO_*tools become available for execution
Core Workflows
1. Trigger a Broadcast
Manually fire a pre-configured broadcast to a specific audience with personalization data.
Tool: CUSTOMERIO_TRIGGER_BROADCAST
| Parameter | Type | Required | Description |
|---|---|---|---|
broadcast_id |
integer | Yes | Broadcast ID from Customer.io Triggering Details |
ids |
array | No | List of customer IDs to target |
emails |
array | No | List of email addresses to target |
recipients |
object | No | Complex filter with and/or/not/segment operators |
per_user_data |
array | No | Per-user personalization with id/email + data |
data |
object | No | Global key-value data for Liquid template personalization |
data_file_url |
string | No | URL to JSON file with per-line user data |
email_add_duplicates |
boolean | No | Allow duplicate recipients (default: false) |
email_ignore_missing |
boolean | No | Skip people without emails (default: false) |
id_ignore_missing |
boolean | No | Skip people without customer IDs (default: false) |
Important: Provide exactly ONE audience option: recipients, ids, emails, per_user_data, or data_file_url. Rate limit: 1 request per 10 seconds per broadcast.
2. Retrieve Message Delivery Metrics
Fetch paginated delivery metrics for messages with filtering by campaign, type, and time window.
Tool: CUSTOMERIO_GET_MESSAGES
| Parameter | Type | Required | Description |
|---|---|---|---|
type |
string | No | Message type: email, webhook, twilio, slack, push, in_app |
metric |
string | No | Metric: attempted, sent, delivered, opened, clicked, converted |
campaign_id |
integer | No | Filter by campaign ID |
newsletter_id |
integer | No | Filter by newsletter ID |
action_id |
integer | No | Filter by action ID |
start_ts |
integer | No | Start of time window (Unix timestamp) |
end_ts |
integer | No | End of time window (Unix timestamp) |
limit |
integer | No | Results per page, 1-1000 (default: 50) |
start |
string | No | Pagination token from previous response next value |
drafts |
boolean | No | Return draft messages instead of active/sent |
3. List Audience Segments
Retrieve all segments defined in your workspace for audience analysis and broadcast targeting.
Tool: CUSTOMERIO_GET_SEGMENTS
No parameters required -- returns all segments with IDs and metadata.
Use segment IDs when targeting broadcasts via the recipients.segment.id filter.
4. List Newsletters
Paginate through all newsletter metadata for tracking and analysis.
Tool: CUSTOMERIO_LIST_NEWSLETTERS
| Parameter | Type | Required | Description |
|---|---|---|---|
limit |
integer | No | Max per page, 1-100 |
sort |
string | No | asc (chronological) or desc (reverse) |
start |
string | No | Pagination cursor from previous response next value |
5. Discover Transactional Message Templates
List all transactional message templates to find IDs for sending via the API.
Tool: CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES
No parameters required -- returns template IDs and trigger names.
6. Inspect Broadcast Trigger History
Review all trigger executions for a broadcast and inspect individual trigger details.
Tools: CUSTOMERIO_GET_TRIGGERS and CUSTOMERIO_GET_TRIGGER
List all triggers for a broadcast:
| Parameter | Type | Required | Description |
|---|---|---|---|
broadcast_id |
integer | Yes | The broadcast/campaign ID |
Get a specific trigger:
| Parameter | Type | Required | Description |
|---|---|---|---|
broadcast_id |
integer | Yes | The campaign/broadcast ID |
trigger_id |
string | Yes | Trigger identifier (e.g., 456 or 5-37) |
Known Pitfalls
| Pitfall | Details |
|---|---|
| Mutually exclusive audience params | CUSTOMERIO_TRIGGER_BROADCAST requires exactly ONE of recipients, ids, emails, per_user_data, or data_file_url -- providing multiple causes errors |
| Rate limiting on broadcasts | Broadcasts are limited to 1 trigger request per 10 seconds per broadcast ID |
| Unix timestamp format | start_ts and end_ts in CUSTOMERIO_GET_MESSAGES must be Unix timestamps, not ISO strings |
| Pagination tokens | Messages and newsletters use cursor-based pagination via the start parameter -- use the next value from previous responses |
| Segment ID resolution | To target a segment in a broadcast, first fetch segment IDs via CUSTOMERIO_GET_SEGMENTS, then reference by ID in recipients.segment.id |
Quick Reference
| Tool Slug | Purpose |
|---|---|
CUSTOMERIO_TRIGGER_BROADCAST |
Trigger a broadcast to a defined audience |
CUSTOMERIO_GET_MESSAGES |
Retrieve message delivery metrics with filters |
CUSTOMERIO_GET_SEGMENTS |
List all audience segments |
CUSTOMERIO_GET_SEGMENT_DETAILS |
Get details for a specific segment |
CUSTOMERIO_LIST_NEWSLETTERS |
Paginate through newsletters |
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES |
List transactional message templates |
CUSTOMERIO_GET_TRIGGERS |
List all trigger executions for a broadcast |
CUSTOMERIO_GET_TRIGGER |
Inspect a specific trigger execution |
Powered by Composio