Customer.io Automation

composio-community/awesome-codex-skillsMarketingAudit failedSnapshot 43bef56ae05f

Installs: 0

Summary

Automate customer engagement workflows including broadcast triggers, message analytics, segment management, and newsletter tracking through Customer.io via Composio

SKILL.md

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

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

No parameters required -- returns all segments with IDs and metadata.

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

No parameters required -- returns template IDs and trigger names.

Parameter	Type	Required	Description
`broadcast_id`	integer	Yes	The broadcast/campaign ID

Parameter	Type	Required	Description
`broadcast_id`	integer	Yes	The campaign/broadcast ID
`trigger_id`	string	Yes	Trigger identifier (e.g., `456` or `5-37`)

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`

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

Customer.io Automation

Summary

SKILL.md

Customer.io Automation

Setup

Core Workflows

1. Trigger a Broadcast

2. Retrieve Message Delivery Metrics

3. List Audience Segments

4. List Newsletters

5. Discover Transactional Message Templates

6. Inspect Broadcast Trigger History

Known Pitfalls

Quick Reference

Related skills