Customer.io

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview

Connect your Customer.io account to Nirvai to automate customer messaging, manage campaigns, and track user behavior.

Supported Authentication Methods

• API Key - Multiple keys for different API endpoints

Prerequisites

• A Customer.io account
• Access to API credentials in your Customer.io workspace

Setup Instructions

API Key Authentication

Customer.io uses two different APIs with separate authentication:

API	Purpose	Authentication
Track API	Send user data and events	Tracking API Key + Site ID
App API	Manage campaigns, segments	App API Key

Step 1: Get Tracking API Credentials

1. Log in to your Customer.io account
2. Go to Settings > Account Settings
3. Click API Credentials
4. Copy your Tracking API Key
5. Copy your Tracking Site ID

Step 2: Get App API Key

1. In API Credentials, find App API Keys
2. Click Create App API Key if needed
3. Give it a name and select permissions
4. Copy the App API Key

Step 3: Select Region

Choose based on your account region:

• Global: track.customer.io (default)
• EU: track-eu.customer.io

Step 4: Configure in Nirvai

1. In Nirvai, select Customer.io API
2. Enter your Tracking API Key
3. Enter your Tracking Site ID
4. Enter your App API Key
5. Select your Region
6. Save the credential

API Endpoints

Region	Track API	App API
Global	track.customer.io/api/v1	api.customer.io/v1/api
EU	track-eu.customer.io/api/v1	api-eu.customer.io/v1/api

Available Operations

With Customer.io credentials, you can:

• Track user events and attributes
• Identify and update customers
• Send transactional messages
• Manage campaigns and broadcasts
• Create and update segments
• Access reporting data

Why Two API Keys?

Customer.io separates concerns:

• Track API: High-volume event ingestion (uses Site ID + Tracking Key)
• App API: Administrative operations (uses App API Key only)

Nirvai uses the appropriate key based on the operation.

Troubleshooting

Common Issues

• 401 Unauthorized: Check your API keys and Site ID
• Wrong Region: Ensure you selected the correct region (Global vs EU)
• Missing Permissions: App API Key may lack required permissions
• Rate Limits: Track API handles high volume; App API has stricter limits

How to Check Your Region

Look at your Customer.io dashboard URL:

• fly.customer.io → Global region
• fly-eu.customer.io → EU region

Related Resources

• Customer.io API Summary
• Track API Documentation
• App API Documentation
• Managing Credentials

---

Adapted from n8n documentation for Nirvai platform

---

Next Steps

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.