Registry / communication / python-intercom

python-intercom

library5.0.1pypypiunverified

The Python Intercom SDK (PyPI project name `python-intercom`, installs `intercom_python_sdk`) provides a convenient way to interact with the Intercom API. It allows developers to manage users, conversations, events, and more. The SDK is currently at version 5.0.1 and is regularly updated through automated API specification regenerations.

communication crm-productivity

pip install python-intercom

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PYTHON-INTERCOM

python-intercom

communicationpythonv5.0.1

Install

4.4s avg

Import

—

Disk

45MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.0.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 46.5MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 4.4s · import 0.000s · 46MB

45MB installed

● package 45MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

IntercomClient

✓ from intercom import IntercomClient

✗ from intercom import IntercomClient

This quickstart demonstrates how to initialize the IntercomClient using an environment variable for security and then fetch a list of users. Ensure `INTERCOM_ACCESS_TOKEN` is set in your environment.

import os from intercom_python_sdk import IntercomClient # Initialize the client with your Personal Access Token # Recommended: Store token in an environment variable named INTERCOM_ACCESS_TOKEN client = IntercomClient(personal_access_token=os.environ.get("INTERCOM_ACCESS_TOKEN", "")) if not client.personal_access_token: print("Error: INTERCOM_ACCESS_TOKEN environment variable not set.") print("Please set it or pass your token directly to IntercomClient(personal_access_token='YOUR_TOKEN')") else: try: # Example: List all users users_list = client.users.list_all(per_page=1) if users_list and users_list.data: print(f"Successfully retrieved {len(users_list.data)} user(s).") for user in users_list.data: print(f" User ID: {user.id}, Email: {user.email}") else: print("No users found or an empty list was returned.") except Exception as e: print(f"An error occurred: {e}")

Debug

Known issues

gotchaThe PyPI project name is `python-intercom`, but the actual Python package/module name you import is `intercom_python_sdk`. Attempting to `pip install intercom_python_sdk` or `pip install python_intercom` will fail.

fix

Always install using `pip install python-intercom`. Always import using `from intercom_python_sdk import ...`.

affects: All versions

breakingVersion 4.0.0 introduced a complete rewrite of the SDK using Fern, leading to significant breaking changes in client initialization, class names, method signatures, and return types. Code written for v3 is incompatible with v4/v5.

fix

Refer to the official GitHub repository's README and examples for the new client structure and API call patterns. Re-evaluate how you initialize the client and make API requests.

affects: 4.0.0 and above

gotchaThe client requires a `personal_access_token` for authentication. Direct inclusion in code is discouraged.

fix

Always use environment variables (e.g., `os.environ.get('INTERCOM_ACCESS_TOKEN')`) to store and retrieve your API token securely.

affects: 4.0.0 and above

Upgrade

Version history

5.0.1latest on PyPI · released Jan 30, 2026

Audit

Dependencies

httpxrequiredHTTP client for API requests.

pydanticrequiredUsed for data validation and models (Fern-generated SDKs).

python-dateutilrequiredDate/time parsing and manipulation.

typing-extensionsrequiredBackports and additions to the typing module.

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/intercom/python-intercom ↗

packagehttps://pypi.org/project/python-intercom/ ↗

homepagehttps://www.intercom.com/ ↗