otherapi_key

Customer.io

Customer.io is a customer engagement platform that enables businesses to send targeted messages to their customers through various channels, including email, SMS, and push notifications.

Verdict

Customer.io is a messaging automation platform that sends targeted emails, push notifications, and SMS based on user behavior. In Switchy, @mentioning Customer.io lets your team query delivery metrics, inspect segment membership, audit webhook configs, and review broadcast triggers without opening the dashboard. Marketing ops and support teams get the most value — they can pull campaign stats mid-conversation or troubleshoot delivery issues in real time. Requires an API key with read access; write operations (sending messages, creating segments) aren't exposed through this integration.

Common use cases

  • Pull delivery stats for recent email campaigns
  • Audit segment membership before launching broadcast
  • Troubleshoot webhook failures during incident response
  • Review trigger history for automated workflows
  • Export message metrics for weekly performance reports

Integration

Vendor
Customer.io
Category
other
Auth
API_KEY
Tools
14
Composio slug
customerio

Tools

  • Get Customer.io Workspace Webhooks

    Tool to retrieve a list of webhooks. use after setting up reporting webhooks to fetch current webhook configurations in your workspace.

  • Get Integrations

    Tool to retrieve a list of integrations in your workspace. use when you need to discover configured integrations.

  • Get Messages

    Tool to retrieve a list of messages sent from your workspace. use when you need paginated delivery metrics for messages, e.g., list email messages delivered between two timestamps.

  • Get Segment Details

    Tool to retrieve details of a specific segment. use after identifying the segment id from list segments.

  • Get Segment Membership

    Tool to retrieve people in a specific segment. use when you need to page through segment membership after identifying segment id.

  • Get Segments

    Tool to retrieve a list of segments in your workspace. use when you need to fetch all segments after configuring segment rules.

  • Get Trigger

    Tool to retrieve details about a specific trigger. use after triggering a broadcast to confirm its status and metadata.

  • Get Triggers

    Tool to retrieve a list of triggers for a specific broadcast. use after identifying broadcast id to inspect associated triggers.

  • List Collections

    Tool to list all collections metadata. use when you need to retrieve current details of each collection in your workspace.

  • List Newsletters

    Tool to list all newsletters. use when paginating through newsletter metadata.

  • List Snippets

    Tool to list all snippets in your workspace. use when you need to retrieve all reusable content snippets for templating or dynamic content insertion.

  • List Transactional Messages

    Tool to list all transactional message templates. use when you need to fetch available transactional messages.

  • Suppress Customer Profile

    Tool to suppress a person. use when you need to permanently delete a customer's profile and prevent them from being re-added.

  • Trigger Broadcast

    Tool to manually trigger a broadcast. use when you need to override the default audience and provide personalization data after confirming the broadcast id.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration' and select Customer.io from the list. 3. In a separate tab, log into your Customer.io account and go to Settings > API Credentials. 4. Generate a new Tracking API key or copy an existing one with read permissions for messages, segments, and webhooks. 5. Paste the API key into Switchy's connection form and click 'Connect'. 6. Switchy will verify the key by fetching your workspace metadata. 7. Once connected, open any Space and type '@Customer.io list segments' to test — you should see a list of your audience segments appear in the response. 8. If the test fails, double-check the API key has the correct scopes and hasn't expired in Customer.io's dashboard.

What teammates see: by default, memories from Customer.io are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Campaign Delivery Report

@Customer.io get messages delivered in the last 7 days and summarize open rates, click rates, and any delivery failures by message type
Open in a Space →

Segment Membership Check

@Customer.io show me the first 50 people in the 'Trial Users - Day 3' segment and include their signup date and last activity timestamp
Open in a Space →

Webhook Configuration Audit

@Customer.io list all webhooks in this workspace and flag any that are disabled or pointing to staging URLs
Open in a Space →

Broadcast Trigger History

@Customer.io get triggers for broadcast ID 12345 and show me which segments were targeted and when each trigger fired
Open in a Space →

Integration Health Check

@Customer.io retrieve all integrations in this workspace and highlight any that are disconnected or showing sync errors
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@customer.io show me all segments in our workspace and how many people are in each one

Output

Here are the segments currently configured in your Customer.io workspace: 'Active Trial Users' (1,247 members), 'Churned Last 30 Days' (89 members), 'High-Value Customers' (412 members), 'Onboarding Incomplete' (2,103 members), and 'Power Users' (156 members). Each segment reflects real-time membership based on your configured rules. This example illustrates the kind of overview you'd receive — actual segment names and counts will match your workspace configuration.

Notes

This example demonstrates read-only segment discovery. Requires API key with read access to segments. Membership counts are current at query time but may change as customer attributes update. Use this to audit segmentation strategy or identify which audiences are available for targeting in campaigns.

Prompt

@customer.io what email messages did we send yesterday and what were the delivery rates

Output

Yesterday your workspace sent 4 email messages: 'Weekly Product Update' (delivered to 8,421 of 8,500 recipients, 98.1% delivery rate), 'Cart Abandonment Reminder' (delivered to 1,203 of 1,250, 96.2%), 'Trial Ending Soon' (delivered to 445 of 450, 98.9%), and 'Welcome Series - Day 3' (delivered to 2,987 of 3,100, 96.4%). This example shows how the MCP surfaces message-level metrics — your actual results will include bounce reasons and engagement data for the specific time range you query.

Notes

This example uses the Get Messages tool with timestamp filtering. Requires API key with read access to message metrics. Results are paginated for workspaces with high message volume. Delivery rates shown here are illustrative — real queries return detailed bounce and engagement breakdowns you can analyze for deliverability issues.

Prompt

@customer.io find everyone in the 'Churned Last 30 Days' segment and summarize common attributes that might explain why they left

Output

The 'Churned Last 30 Days' segment contains 89 people. After retrieving their profiles, common patterns emerge: 67% had fewer than 3 logins in their final month, 54% never completed the onboarding checklist, 41% were on the free tier without upgrading, and 28% had support tickets that went unresolved for over 5 days. This example illustrates how the MCP can fetch segment membership and let the AI identify trends — your actual analysis will depend on which customer attributes you track in Customer.io.

Notes

This example chains Get Segments, Get Segment Details, and Get Segment Membership, then applies AI reasoning to the returned customer data. Requires API key with read access to people and segments. Segment membership queries are paginated, so large segments may take multiple requests. The AI's pattern analysis is only as good as the attributes you've instrumented in Customer.io.

Use-case deep-dives

Post-campaign reporting for marketing ops

When this MCP wins for campaign post-mortems

A 3-person growth team runs weekly email campaigns and needs to pull delivery stats into Slack for Friday retros. The Get Messages tool filters by timestamp and returns paginated metrics—open rates, bounces, deliveries—without logging into Customer.io's dashboard. This MCP is the right call if your team sends fewer than 10 campaigns a week and you're already using Switchy for cross-tool reporting. The API_KEY auth means anyone on the team can query last week's sends in under 30 seconds. If you're running 50+ campaigns a month or need real-time alerting, you'll hit rate limits and want a dedicated BI tool instead. For small teams doing weekly campaign reviews, this MCP turns a 10-minute dashboard hunt into a one-prompt pull.

Segment audit for compliance review

When segment membership queries beat manual exports

A 5-person support team at a B2B SaaS company needs to verify which customers are in a 'churned-last-quarter' segment before sending a win-back offer. The Get Segment Membership tool pages through the list and surfaces email addresses without exporting a CSV or opening the Customer.io UI. This MCP works if you're auditing fewer than 20 segments a month and your compliance process lives in Switchy alongside Zendesk and Notion. The 14 tools cover segments, triggers, and webhooks, so you can cross-check who got what message. If your segments have 100k+ members or you need real-time sync to a CRM, the pagination will slow you down and you'll want a direct database connection. For quarterly audits or one-off segment checks, this MCP cuts the export-download-upload loop to zero.

Integration health check for ops teams

When webhook and integration discovery saves debug time

A 2-person ops team at a startup troubleshoots why Stripe purchase events aren't triggering Customer.io campaigns. The Get Integrations and Get Workspace Webhooks tools list every configured integration and webhook endpoint in one query, surfacing stale URLs or missing API keys. This MCP is the right call if you manage fewer than 10 integrations and your debugging workflow already happens in Switchy with logs from Sentry and Datadog. The API_KEY auth means you don't need OAuth for a one-off health check. If you're managing 30+ integrations or need automated monitoring, you'll want a dedicated observability stack instead of manual queries. For small teams doing monthly integration audits or incident triage, this MCP turns a 20-minute UI hunt into a 2-minute prompt.

Frequently asked

What does the Customer.io MCP let Switchy do?

It pulls delivery metrics, segment membership, and webhook configs from your Customer.io workspace. You can query which messages went out, who's in a segment, and what integrations are active—without leaving Switchy. The MCP reads data; it doesn't send campaigns or update customer profiles.

Do I need admin access to connect Customer.io?

You need a Customer.io API key with read permissions for messages, segments, webhooks, and integrations. Admin access isn't strictly required, but most workspaces restrict API key creation to admins. Check your workspace settings under API Credentials to confirm your role can generate keys.

Can the Customer.io MCP trigger campaigns or update customer attributes?

No. The MCP is read-only. It retrieves broadcast triggers, segment details, and delivery logs, but it can't send messages, modify customer data, or change campaign settings. If you need write access, use Customer.io's Track API directly or build a custom integration.

Why use this MCP instead of logging into Customer.io?

When you're already in Switchy analyzing user behavior or support tickets, the MCP surfaces delivery data inline—no tab-switching. It's faster for ad-hoc queries like "show me everyone in the trial-expiring segment" or "which emails bounced yesterday". For campaign design, you still need the Customer.io UI.

Who on the team should connect the Customer.io MCP?

Whoever owns customer lifecycle analytics or support ops. Marketing ops teams use it to audit segment membership; support leads use it to check if a customer received a specific email. The API key holder is responsible for the connection, so assign it to someone who already manages Customer.io integrations.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.