{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}
At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key from
CUSTOMERIO_APP_API_KEYis sent as theBearerprefixedAuthorizationheader. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.
Setup
- Create a Customer.io account: Sign up at https://customer.io/ - the free trial includes a full workspace suitable for development and testing.
- Create an App API key: In Customer.io go to Settings > Account Settings > API Credentials, open the App API Keys tab, and create a key. Scope it to the workspace and permissions your agents need (read access plus transactional send if you use the email tool).
- Set the environment variable: Copy the key into CUSTOMERIO_APP_API_KEY. It is sent as a Bearer token in the Authorization header on every request.
- Optional: set up a transactional message: To send templated transactional email, create a Transactional message in Customer.io and use its ID or trigger name as transactional_message_id.
Provider notes
- Customer.io has US and EU regions. This connector targets the US host api.customer.io; if your workspace is in the EU data center, replace the host with api-eu.customer.io in the tool URLs.
- These tools use the App API (Bearer App API key). The separate Track API (track.customer.io) for identifying people and sending events uses HTTP Basic auth with a site ID and Track API key and is not covered by this connector.
- App API rate limits: most endpoints allow 10 requests per second; transactional sends allow 100 requests per second.
Tools
Verify the connection
Call a read tool such as customer-io__search_customers with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.