customer-io

Customer.io through One

Customer.io is a customer engagement platform that provides messaging automation, data-driven segmentation, and multichannel campaign orchestration, allowing teams to trigger personalized emails, SMS, push notifications, and in-app messages based on user behavior and lifecycle events.

One exposes Customer.io through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform customer-io if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Customer.io is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Customer.io account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Newsletters

Action	Method	Path	Action id
Get a Newsletter	GET	/v1/newsletters/{{newsletterId}}	conn_mod_def::GMXukPwNiwg::w2ehsKnHQhO9dZE9Ig1ZUg
Get a Newsletter Translation	GET	/v1/newsletters/{{newsletterId}}/language/{{language}}	conn_mod_def::GMXukAa9meA::L8x6f2J1ScGeIzzfLf4dzg
Get a Newsletter Variant	GET	/v1/newsletters/{{newsletterId}}/contents/{{contentId}}	conn_mod_def::GMXukAZfozA::MDMA_dM8TpS4Z_zVHd9pwQ
Get Metrics for a Newsletter	GET	/v1/newsletters/{{newsletterId}}/metrics	conn_mod_def::GMXuj2sIkBg::0NIjfLX1TCaGhHfssmmRLQ
List Newsletters	GET	/v1/newsletters	conn_mod_def::GMXukPu8Rlg::8mo_RqB5Tf-yaEA-zhi6OQ
Add a Translation to a Newsletter	POST	/v1/newsletters/{{newsletterId}}/language	conn_mod_def::GMXuj1y0u0A::2ljp8YB6RfmDiaAR1eoqWw
Add a Translation to a Newsletter Test Group	POST	/v1/newsletters/{{newsletterId}}/test_group/{{testGroupId}}/language	conn_mod_def::GMXuj5MZv_A::qAKrQvL5QrmVr0wY5pB7UQ
Create a Newsletter	POST	/v1/newsletters	conn_mod_def::GMXukPg_Bng::0-r9xsZARFCcnGEwzalYlA
Create a Test Group for a Newsletter	POST	/v1/newsletters/{{newsletterId}}/test_groups	conn_mod_def::GMXukAZfJjA::O718xexfSKG9vmw60BipUQ
Delete a Newsletter	DELETE	/v1/newsletters/{{newsletterId}}	conn_mod_def::GMXukPNV7hA::lEEtV7PQQRCyqBlJeuFYTA
Delete a Translation in a Newsletter Test Group	DELETE	/v1/newsletters/{{newsletterId}}/test_group/{{testGroupId}}/language/{{language}}	conn_mod_def::GMXukAcsp5A::GzpIRi_mR0SDNNOwcsvwMA
Delete a Translation of a Newsletter	DELETE	/v1/newsletters/{{newsletterId}}/language/{{language}}	conn_mod_def::GMXukAst0Pg::44OlkfyOTbyl6XvRtsG8ag