customerio

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 on this page — 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

customerio on PyPI

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

Evidence: customerio-3.2.0-py3-none-any.whl

Tags

More WWW/HTTP packages