Customer.io Automation
Helps your agent send messages and track customers. It manages lists and sends newsletters automatically.
What it does
This tool automates sending messages to customers via Customer.io. You can trigger campaigns, view delivery metrics, and manage contact lists.
When to use it
- ✓Trigger an email campaign for a specific group of customers.
- ✓Check how many people opened or clicked an email.
- ✓List all contact groups (segments) you have registered.
Example of what to ask your AI
“Trigger the 'Summer Sale' campaign for customers with IDs 123 and 456.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You connect your Customer.io account to the system. Then, you can ask to trigger campaigns or retrieve information about message sending.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add ComposioHQ/awesome-claude-skills --skill Customer.io AutomationOr download just the file:
curl -L https://raw.githubusercontent.com/ComposioHQ/awesome-claude-skills/master/composio-skills/customerio-automation/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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 |
|---|
…
FAQ
How do I connect my Customer.io account?
You need to connect your account through the link provided in the system's initial setup.
Can I send to specific customers?
Yes, you can send to specific customers using their IDs or emails, or to entire groups (segments).
How do I see sending metrics?
You can ask to see metrics like delivered, opened, and clicked, filtering by campaign or time period.
Details
Original description by the author
Automate customer engagement workflows including broadcast triggers, message analytics, segment management, and newsletter tracking through Customer.io via Composio
Popularity
- GitHub stars
- 77k
- Ranking position
- #1061
- License
- —
- Updated
- 9/18/2026
Comments
- …
More skills from this repository
artifacts-builder
Helps your agent build complex user interfaces. It uses modern technologies to create rich, interactive web pages.
ComposioHQ/awesome-claude-skills
brand-guidelines
Helps your agent apply official brand colors and fonts to materials. It's useful for maintaining visual identity in any piece that needs to look like the company's.
ComposioHQ/awesome-claude-skills
canvas-design
Lets your agent create original visual art in .png and .pdf. Use it when the user asks to create a poster, art, or other static design.
ComposioHQ/awesome-claude-skills
changelog-generator
Helps your agent create user-facing release notes from code commits. It transforms technical information into easy-to-understand text.
ComposioHQ/awesome-claude-skills
Similar skills
benchmark
Helps your agent measure code speed and performance. It's useful for ensuring things are fast and finding slowness issues.
affaan-m/ECC
content-hash-cache-pattern
Lets your agent use content hashes to cache file processing results. This avoids repeated processing and auto-invalidates the cache when content changes. Useful for speeding up slow tasks.
affaan-m/ECC
parallel-execution-optimizer
Makes your agent speed up complex tasks by breaking them into smaller parts and running them in parallel. It ensures everything is verified at the end.
affaan-m/ECC