---
id: customerio-cdp-analytics
version: "1.0.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# customerio-cdp-analytics — Customer.io Data Pipelines (CDP) Python bindings.

License: permissive · Maintenance: active · Downloads: 112.7K/mo

## What it is and what it does

This is a Python client library for Customer.io's Data Pipelines platform, designed to send event tracking and user data from your application to Customer.io for analytics and customer engagement workflows. It wraps HTTP requests to Customer.io's CDP endpoints, handling authentication via a write key and supporting configuration of alternate data centers (e.g., EU regions). The library depends on requests for HTTP transport, backoff for retry logic, monotonic for timing, and python-dateutil for date handling.

You initialize it with a write key, then call methods like track() to log user events. The library is actively maintained, supports Python 3.9 through 3.14, and carries no known security vulnerabilities. It's a thin integration layer rather than a full analytics platform—its role is to reliably forward events to Customer.io's backend.

Use it for:

- Log user actions (purchases, sign-ups, feature usage) to Customer.io for segmentation and campaign targeting.
- Integrate event tracking into a Python web application or backend service.
- Send user profile updates to Customer.io for real-time personalization.
- Route events to Customer.io's EU data center when compliance requires regional data residency.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sends event and user data to Customer.io's Data Pipelines platform for analytics and customer engagement tracking.

Yes, if you are already using Customer.io and need a Python client to send events to their platform. The package is actively maintained, has low install friction, carries an MIT license, and supports current Python versions. No known vulnerabilities. Install it as part of your Customer.io integration; do not install it if you are not using Customer.io's CDP.

## Install

pip install customerio-cdp-analytics
uv add customerio-cdp-analytics
poetry add customerio-cdp-analytics

## Installing customerio-cdp-analytics

Before you install: Low friction installation with four lightweight runtime dependencies. Active maintenance as of June 2026, with recent release activity.

License in practice: MIT license permits commercial and private use with minimal restrictions—suitable for most projects.

Quickstart:

pip install customerio-cdp-analytics

from customerio import analytics
analytics.write_key = 'YOUR_WRITE_KEY'
analytics.track(user_id=4, event='order_complete')

Requires a valid Customer.io write key and network connectivity to Customer.io's CDP endpoint.

Verify before relying:

- Whether the package handles offline queueing or requires synchronous network calls.
- Rate limiting and retry behavior beyond what backoff dependency provides.
- Support for batch operations or only single-event tracking.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 112.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

customer.io analytics client, CDP event tracking python, customer data platform integration, event tracking API, customer.io python SDK, analytics, customer-engagement, event-tracking

[View on SkillFed](https://skillfed.io/packages/customerio-cdp-analytics) · [View on PyPI](https://pypi.org/project/customerio-cdp-analytics/)