Skip to content
Customer.io Automation logo

Customer.io Automation

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

SKILL.md

Full skill instructions

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

  1. Connect your Customer.io account through the Composio MCP server at https://rube.app/​mcp
  2. The agent will prompt you with an authentication link if no active connection exists
  3. 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

ParameterTypeRequiredDescription
broadcast_idintegerYesBroadcast ID from Customer.io Triggering Details
idsarrayNoList of customer IDs to target
emailsarrayNoList of email addresses to target
recipientsobjectNoComplex filter with and/or/not/segment operators
per_user_dataarrayNoPer-user personalization with id/email + data
dataobjectNoGlobal key-value data for Liquid template personalization
data_file_urlstringNoURL to JSON file with per-line user data
email_add_duplicatesbooleanNoAllow duplicate recipients (default: false)
email_ignore_missingbooleanNoSkip people without emails (default: false)
id_ignore_missingbooleanNoSkip 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

ParameterTypeRequiredDescription
typestringNoMessage type: email, webhook, twilio, slack, push, in_app
metricstringNoMetric: attempted, sent, delivered, opened, clicked, converted
campaign_idintegerNoFilter by campaign ID
newsletter_idintegerNoFilter by newsletter ID
action_idintegerNoFilter by action ID
start_tsintegerNoStart of time window (Unix timestamp)
end_tsintegerNoEnd of time window (Unix timestamp)
limitintegerNoResults per page, 1-1000 (default: 50)
startstringNoPagination token from previous response next value
draftsbooleanNoReturn 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

ParameterTypeRequiredDescription
limitintegerNoMax per page, 1-100
sortstringNoasc (chronological) or desc (reverse)
startstringNoPagination 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:

ParameterTypeRequiredDescription
broadcast_idintegerYesThe broadcast/​campaign ID

Get a specific trigger:

ParameterTypeRequiredDescription
broadcast_idintegerYesThe campaign/​broadcast ID
trigger_idstringYesTrigger identifier (e.g., 456 or 5-37)

Known Pitfalls

PitfallDetails
Mutually exclusive audience paramsCUSTOMERIO_TRIGGER_BROADCAST requires exactly ONE of recipients, ids, emails, per_user_data, or data_file_url -- providing multiple causes errors
Rate limiting on broadcastsBroadcasts are limited to 1 trigger request per 10 seconds per broadcast ID
Unix timestamp formatstart_ts and end_ts in CUSTOMERIO_GET_MESSAGES must be Unix timestamps, not ISO strings
Pagination tokensMessages and newsletters use cursor-based pagination via the start parameter -- use the next value from previous responses
Segment ID resolutionTo 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 SlugPurpose
CUSTOMERIO_TRIGGER_BROADCASTTrigger a broadcast to a defined audience
CUSTOMERIO_GET_MESSAGESRetrieve message delivery metrics with filters
CUSTOMERIO_GET_SEGMENTSList all audience segments
CUSTOMERIO_GET_SEGMENT_DETAILSGet details for a specific segment
CUSTOMERIO_LIST_NEWSLETTERSPaginate through newsletters
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGESList transactional message templates
CUSTOMERIO_GET_TRIGGERSList all trigger executions for a broadcast
CUSTOMERIO_GET_TRIGGERInspect a specific trigger execution

Powered by Composio

More skills from boisenoise

database-cloud-optimization-cost-optimize logo
boisenoise/skills-collections

database-cloud-optimization-cost-optimize

You are a cloud cost optimization expert specializing in reducing infrastructure expenses while maintaining performance and reliability. Analyze cloud spending, identify savings opportunities, and implement cost-effective architectures across AWS, Azure, and GCP.

10 0
View
postmark-automation logo
boisenoise/skills-collections

postmark-automation

Automate Postmark email delivery tasks via Rube MCP (Composio): send templated emails, manage templates, monitor delivery stats and bounces. Always search tools first for current schemas.

10 0
View
game-development logo
boisenoise/skills-collections

game-development

Game development orchestrator. Routes to platform-specific skills based on project needs.

10 0
View
test-fixing logo
boisenoise/skills-collections

test-fixing

Systematically identify and fix all failing tests using smart grouping strategies. Use when explicitly asks to fix tests (\"fix these tests\", \"make tests pass\"), reports test failures (\"tests are failing\", \"test suite is broken\"), or completes implementation and wants tests passing.

10 0
View
notebooklm logo
boisenoise/skills-collections

notebooklm

Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes.

10 0
View
agent-evaluation logo
boisenoise/skills-collections

agent-evaluation

Testing and benchmarking LLM agents including behavioral testing,

10 0
View
clickup-automation logo
boisenoise/skills-collections

clickup-automation

Automate ClickUp project management including tasks, spaces, folders, lists, comments, and team operations via Rube MCP (Composio). Always search tools first for current schemas.

10 0
View
wordpress-penetration-testing logo
boisenoise/skills-collections

wordpress-penetration-testing

Assess WordPress installations for common vulnerabilities and WordPress 7.0 attack surfaces.

10 0
View
ln-761-secret-scanner logo
boisenoise/skills-collections

ln-761-secret-scanner

Scans codebase for hardcoded secrets with severity classification and remediation guidance. Use when auditing a project for leaked credentials.

10 0
View
azure-monitor-ingestion-java logo
boisenoise/skills-collections

azure-monitor-ingestion-java

Azure Monitor Ingestion SDK for Java. Send custom logs to Azure Monitor via Data Collection Rules (DCR) and Data Collection Endpoints (DCE).

10 0
View
ln-513-agent-reviewer logo
boisenoise/skills-collections

ln-513-agent-reviewer

Runs parallel external agent reviews (Codex + Gemini) on code changes. Process-as-arrive, critical verification with debate. Returns filtered suggestions.

10 0
View
drip-jobs-automation logo
boisenoise/skills-collections

drip-jobs-automation

Automate Drip Jobs tasks via Rube MCP (Composio). Always search tools first for current schemas.

10 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View