---
id: customerio
version: "3.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# customerio — Customer.io Python bindings.

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

## What it is and what it does

The customerio package is an official Python client for Customer.io, a customer data and engagement platform. It wraps Customer.io's REST API, letting you programmatically manage customer profiles, track behavioral events, and send transactional messages from within your Python application.

The library handles authentication via site ID and API key, supports US and EU region selection, and provides methods for core operations: identifying or updating customer profiles with custom attributes, tracking events with optional timestamps and deduplication IDs, backfilling historical events, managing devices, suppressing customers, and sending transactional emails. It depends only on requests and urllib3 for HTTP communication.

Use it for:

- Track user behavior events (purchases, sign-ups, feature usage) in real-time to feed Customer.io campaigns and journeys
- Identify and update customer profiles with custom attributes when users sign up or update their account information
- Send transactional emails (password resets, order confirmations) through Customer.io's Transactional API
- Backfill historical events for data migration or retroactive campaign targeting
- Manage customer suppression lists to honor opt-outs and privacy requests programmatically

## Worth the install?

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

Python client library for the Customer.io API, enabling you to identify customers, track events, manage customer profiles, and send transactional messages programmatically.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and is production-stable. Install it if you need to integrate Customer.io into a Python application for customer tracking, profile management, or transactional messaging.

## Install

pip install customerio
uv add customerio
poetry add customerio

## Installing customerio

Before you install: Low install friction with only two runtime dependencies (requests and urllib3). The package is actively maintained with a recent release and supports current Python versions (3.10 through 3.14).

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install customerio

from customerio import CustomerIO, Regions

cio = CustomerIO(site_id="your_site_id", api_key="your_api_key", region=Regions.US)
cio.identify(id="5", email="customer@example.com", name="Bob")
cio.track(customer_id="5", name="purchased", data={"price": 23.45})

Requires Python 3.10 or later; you must obtain a Customer.io site ID and API key from your account settings.

Verify before relying:

- Whether the package handles automatic retries or rate-limiting for API calls
- Performance characteristics when tracking high-volume events
- Whether webhook or callback support is available for asynchronous operations

## Package facts

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

## Tags

customer.io api client, customer data platform python, event tracking sdk, customer profile management, transactional email api, customer engagement platform, cdp integration, customer-engagement, api-client, event-tracking

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