
CUSTOMER.IO n8n INTEGRATION: AUTOMATE CUSTOMER.IO WITH N8N
CUSTOMER.IO N8N INTEGRATION: AUTOMATE CUSTOMER.IO WITH N8N
Need help automating Customerio with n8n?
Our team will get back to you in minutes.
Why automate Customerio with n8n?
The Customer.io n8n integration gives you access to 1 trigger capable of monitoring over 20 event types and 9 actions spanning customer management, event tracking, segment operations, and campaign analytics. This means you can build end-to-end marketing automation that reacts instantly to customer behavior and pushes data wherever it needs to go.
Significant time savings: No more manual exports or constant dashboard checking. Set up smart rules that automatically process customer data, update records, and trigger follow-up actions. What used to take hours of manual work now happens in milliseconds. Improved responsiveness: Trigger instant actions the moment a customer opens an email, clicks a link, or unsubscribes. Your team can react to customer behavior in real-time rather than discovering issues days later. Zero oversight: The Watch Events trigger monitors your Customer.io workspace 24/7. Every subscription change, delivery failure, or engagement event immediately triggers your workflow—nothing slips through the cracks. Seamless integration: Connect Customer.io to hundreds of applications in n8n's ecosystem, from Slack and Google Sheets to Salesforce and custom webhooks.
Concrete use cases include: automatically adding high-engagement customers to VIP segments, syncing unsubscribes to your CRM in real-time, triggering Slack alerts when email deliveries fail, building comprehensive campaign performance dashboards, and enriching customer profiles with data from external sources. The possibilities multiply when you combine Customer.io's granular event data with n8n's workflow capabilities.
How to connect Customerio to n8n?
! 1 stepHow to connect Customerio to n8n?
- 01
Add the node
The Customer.io n8n integration uses API Key authentication with two separate keys: a Tracking API Key for sending data to Customer.io and an App API Key for reading data from your account.Basic configuration:Access your Customer.io settings: Log into your Customer.io account and navigate to Settings > API Credentials to find your API keys.Copy your Tracking API Key: This key is used for actions that send data to Customer.io (creating customers, tracking events). Copy the Site ID and API Key from the Tracking API section.Copy your App API Key: For actions that read data (getting campaigns, metrics), you'll need an App API Key. Generate one if you haven't already and copy it.Configure credentials in n8n: In your n8n workflow, add a Customer.io node, click on "Credential to connect with," then "Create New." Enter your keys in the appropriate fields.Test the connection: Save your credentials and run a test to verify the connection is working properly before building your workflow.
TIP💡 TIP: Create separate credentials for different environments (staging vs. production) to avoid accidentally modifying live customer data during testing. Label them clearly like "Customer.io - Production" and "Customer.io - Staging" so you never mix them up. For more advanced n8n configuration tips, check out our n8n training.- 01
Need help automating Customerio with n8n?
Our team will get back to you in minutes.
Customerio triggers available in n8n
01 Trigger 01Watch Events
The Watch Events trigger is the cornerstone of any Customer.io automation in n8n. It continuously monitors your Customer.io workspace and fires your workflow the instant a specified event occurs. Think of it as having a tireless assistant watching every customer interaction and immediately taking action based on your rules.
What makes this trigger particularly powerful is its granular event selection. You're not limited to broad categories—you can cherry-pick exactly which events matter to your workflow. Want to track only email bounces and unsubscribes? Done. Need to monitor SMS delivery failures alongside push notification opens? Easy. This precision ensures your workflows only fire when truly relevant, keeping your automation lean and efficient.
Configuration parameters:
- Credential to connect with: This required dropdown lets you select which Customer.io account to monitor. Choose the credential you configured earlier to authenticate the webhook connection.
- Events: This required multi-select field is where the magic happens. You can choose from dozens of event types organized by channel: Email events (Email Sent, Email Delivered, Email Opened, Email Clicked, Email Bounced, Email Marked as Spam, Email Unsubscribed), SMS events (SMS Sent, SMS Delivered, SMS Failed, SMS Clicked), Push events (Push Sent, Push Delivered, Push Opened, Push Failed), Subscription events (Customer Subscribed, Customer Unsubscribed), and Slack events (Slack Sent, Slack Clicked, Slack Failed).
Typical use cases:
- Engagement-based segmentation: When an email is opened or clicked, automatically add that customer to a high-engagement segment and trigger a follow-up campaign.
- Delivery failure alerts: Monitor SMS Failed and Email Bounced events to instantly notify your team via Slack when messages aren't reaching customers.
- Churn prevention: Watch for Customer Unsubscribed events to trigger win-back workflows or update your CRM with the latest subscription status.
- Cross-channel analytics: Aggregate all engagement events into Google Sheets or a data warehouse for comprehensive reporting.
When to use it: Use Watch Events whenever you need to react to customer behavior in real-time. It's ideal for triggered campaigns, real-time dashboards, cross-platform syncing, and any scenario where immediate action based on customer activity creates business value.

Customerio actions available in n8n
01 Action 01Create or Update Customer
The Create or Update Customer action is your primary tool for managing customer data in Customer.io from external sources. It follows an "upsert" pattern: if a customer with the specified ID exists, it updates their record; if not, it creates a new one. This eliminates the need for separate create and update logic in your workflows.
Key parameters:
- Credential to connect with: Required dropdown to select your Customer.io account credentials.
- Resource: Set to "Customer" to operate on customer records.
- Operation: Set to "Create or Update" for the upsert behavior.
- ID: Required text field where you enter the unique customer identifier. This is how Customer.io determines whether to create or update.
- JSON Parameters: Toggle to enable raw JSON input for complex data structures.
- Additional Fields: Expandable section to add custom attributes like email, name, plan type, or any custom properties.
Use cases: Sync new leads from your website form to Customer.io, update customer attributes when they make a purchase, import customers from a CSV via Google Sheets, or enrich profiles with data from third-party APIs.

02 Action 02Delete Customer
The Delete Customer action permanently removes a customer record from Customer.io. Use this for GDPR compliance workflows, cleaning up test data, or removing customers who have explicitly requested data deletion.
Key parameters:
- Credential to connect with: Required dropdown for authentication.
- Resource: Set to "Customer."
- Operation: Set to "Delete."
- ID: Required text field specifying which customer to delete. Double-check this value—deletion is permanent.
Use cases: Automate GDPR "right to be forgotten" requests by connecting a form submission to this action, clean up test customers after QA, or remove duplicate records identified by another workflow.

03 Action 03Track Event
Track Event lets you record custom events for identified customers in Customer.io. These events can then trigger campaigns, update segments, or be used for analytics. It's essential for tracking in-app behavior, purchases, or any customer action that happens outside Customer.io.
Key parameters:
- Credential to connect with: Required dropdown for account selection.
- Resource: Set to "Event."
- Operation: Set to "Track."
- Customer ID: Required text field identifying which customer performed the event.
- Event Name: Required text field for the event name (e.g., "purchase_completed", "feature_used", "support_ticket_opened").
- JSON Parameters: Toggle to pass additional event properties in JSON format.
- Additional Fields: Add custom event data like product name, amount, or category.
Use cases: Track purchases from your e-commerce platform, record feature usage from your product, log support interactions, or capture any custom action that should influence your marketing automation.

04 Action 04Track Anonymous
Track Anonymous records events for visitors who haven't been identified yet. This is crucial for tracking pre-signup behavior that you want to associate with a customer profile later. Customer.io will merge these events once the anonymous visitor is identified.
Key parameters:
- Credential to connect with: Required dropdown for authentication.
- Resource: Set to "Event."
- Operation: Set to "Track Anonymous."
- Event Name: Required text field for the event name.
- JSON Parameters: Toggle for passing additional data in JSON format.
- Additional Fields: Add custom properties relevant to the anonymous event.
Use cases: Track page views or content downloads before signup, record pricing page visits for sales intelligence, or capture product demo requests from anonymous visitors.

05 Action 05Get Campaign
Get Campaign retrieves detailed information about a specific campaign in your Customer.io account. Use it to check campaign status, pull configuration details, or gather data for reporting workflows.
Key parameters:
- Credential to connect with: Required dropdown for account authentication.
- Resource: Set to "Campaign."
- Operation: Set to "Get."
- Campaign ID: Required text field where you enter the unique identifier of the campaign to retrieve.
Use cases: Build campaign status dashboards, verify campaign configuration before triggering updates, or aggregate campaign data for cross-platform reporting.

06 Action 06Get Many Campaigns
Get Many Campaigns retrieves a list of multiple campaigns from your Customer.io account. It's perfect for building overview reports or workflows that need to iterate through all your campaigns.
Key parameters:
- Credential to connect with: Required dropdown for selecting your credentials.
- Resource: Set to "Campaign."
- Operation: Set to "Get Many."
Use cases: Generate weekly campaign performance reports, build a master list of all active campaigns, or create workflows that check multiple campaign statuses in sequence.

07 Action 07Get Metrics
Get Metrics pulls performance data for a specific campaign, including delivery rates, open rates, click rates, and conversion metrics. This action is essential for building automated reporting workflows.
Key parameters:
- Credential to connect with: Required dropdown for authentication.
- Resource: Set to "Campaign."
- Operation: Set to "Get Metrics."
- Campaign ID: Required text field specifying which campaign's metrics to retrieve.
- Period: Dropdown to select the time frame for metrics (e.g., "Days").
- JSON Parameters: Toggle for advanced configuration options.
- Additional Fields: Add extra parameters for more specific metric queries.
Use cases: Build daily/weekly campaign performance reports in Google Sheets, trigger alerts when metrics fall below thresholds, or feed campaign data into BI tools for deeper analysis.

08 Action 08Add Customer
Add Customer adds one or more customers to a specific segment in Customer.io. Segments are powerful for targeting campaigns, so dynamically managing segment membership based on external triggers unlocks sophisticated personalization.
Key parameters:
- Credential to connect with: Required dropdown for account selection.
- Resource: Set to "Segment."
- Operation: Set to "Add Customer."
- Segment ID: Required text field for the target segment's unique identifier.
- Customer IDs: Required text field where you list the customer IDs to add (typically comma-separated).
Use cases: Add customers who completed a purchase to a "Buyers" segment, move high-engagement users into a VIP segment based on activity scores, or segment customers based on data from external systems.

09 Action 09Remove Customer from Segment
Remove Customer from Segment removes one or more customers from a specified segment. This is the counterpart to Add Customer and is essential for maintaining accurate segment membership as customer status changes.
Key parameters:
- Credential to connect with: Required dropdown for authentication.
- Resource: Set to "Segment."
- Operation: Set to "Remove Customer."
- Segment ID: Required text field identifying the segment to modify.
- Customer IDs: Required text field listing which customers to remove from the segment.
Use cases: Remove churned customers from active user segments, update segment membership when subscription tiers change, or clean up segments based on inactivity thresholds.

Build your first workflow with our team
Drop your email and we'll send you the catalog of automations you can ship today.
- Free n8n & Make scenarios to import
- Step-by-step setup docs
- Live cohort + community support
Frequently asked questions
Is the Customer.io n8n integration free to use?
The integration itself is completely free within n8n—there are no additional costs to connect Customer.io to your workflows. However, you do need active accounts on both platforms. n8n offers a free self-hosted option and a cloud version with a generous free tier. Customer.io is a paid marketing automation platform with pricing based on your customer profile count. So while the integration bridge costs nothing, you'll need appropriate plans on each platform. For teams already using both tools, this integration adds significant value at zero extra cost.What types of events can I track and sync between Customer.io and n8n?
The Watch Events trigger supports over 20 event types across all Customer.io channels. You can monitor email events (sent, delivered, opened, clicked, bounced, spam marked, unsubscribed), SMS events (sent, delivered, failed, clicked), push notification events (sent, delivered, opened, failed), Slack events (sent, clicked, failed), and subscription events (customer subscribed/unsubscribed). On the action side, you can track custom events for both identified customers and anonymous visitors. This comprehensive coverage means you can build workflows that respond to virtually any customer interaction happening within Customer.io.How long does it take to set up the Customer.io n8n integration?
Most users have their first working automation running within 15-30 minutes. The credential setup takes about 5 minutes—you'll need to copy your API keys from Customer.io and paste them into n8n. Building a basic workflow (e.g., "when email bounces, send Slack notification") takes another 5-10 minutes thanks to n8n's visual interface. More complex workflows with multiple conditions and actions might take 30-60 minutes depending on your requirements. The learning curve is gentle, especially if you're familiar with any visual automation tool. n8n provides clear error messages and a test feature for each node, making debugging straightforward. If you need help troubleshooting, our n8n troubleshooting guide covers common issues, and you can also explore the official n8n documentation for detailed references.



