Customer.io Automation

Customer.io Automation Capabilities

Skill Overview

Using the Composio MCP integration to automate Customer.io customer engagement actions, including triggering targeted broadcasts, retrieving message performance metrics, and managing audience segmentation.

Use Cases

1. Marketing Campaign Automation

Automatically trigger preconfigured broadcasts to target audiences. Supports personalized data and complex audience filtering. Ideal for scenarios requiring periodic sending of marketing emails, product updates, or promotional campaigns—allowing precise targeting by customer ID, email, or segment.

2. Message Performance Analysis

Retrieve detailed email and messaging delivery metrics, including send, delivered, opened, clicked, and conversion data. Supports filtering by campaign ID, time range, and message type, helping marketing teams evaluate campaign performance and optimize strategies.

3. Audience Management and Analysis

List all customer segments and retrieve detailed information to understand audience structure and characteristics. Segments can be used with segment IDs to precisely target specific audience groups in broadcasts, enabling more refined operations.

Core Functions

Trigger Broadcasts

Manually trigger a preconfigured broadcast to a specified audience. Supports multiple audience targeting methods (customer IDs, email lists, segments, or complex filters) and provides personalized data injection. Note: Only one audience targeting method can be used per request, and each broadcast can trigger at most once every 10 seconds.

Retrieve Message Metrics

Fetch paginated message delivery metrics. Supports filtering by message type (email, Webhook, SMS, push, etc.), metric type (attempt, send, delivered, opened, clicked, converted), and time window.

Manage Audience Segmentation

List all customer segments defined in the workspace and retrieve segment IDs and metadata. Segment IDs can be used for audience targeting in broadcasts, enabling precise marketing based on user attributes.

Newsletters and Transactional Message Management

List all newsletter metadata to discover transactional message templates and their trigger names, making it easy to send transactional messages via API.

View Trigger History

View all broadcast trigger execution records, including detailed information for each trigger, to track and audit marketing campaign execution.

FAQs

How do I connect Customer.io to Composio?

Connect your Customer.io account via the Composio MCP server (https://rube.app/mcp). If no connection exists yet, the system will prompt you to authenticate. After connecting, all CUSTOMERIO_* tools will be available.

What limitations apply to broadcast triggers?

Broadcast triggers have two main restrictions: (1) audience parameters are mutually exclusive—you must and can provide only one of recipients, ids, emails, per_user_data, or data_file_url; and (2) rate limits—each broadcast can trigger at most one request every 10 seconds.

How do I correctly use time range filters?

For the CUSTOMERIO_GET_MESSAGES tool, the start_ts and end_ts parameters must use Unix timestamp format, not ISO date strings. Message and newsletter pagination uses cursor-based pagination, so you must obtain the pagination token from the next value in the previous response.