python-intercom

What it is and what it does

python-intercom is a generated SDK that wraps the Intercom REST API, allowing Python developers to interact with Intercom's customer messaging, data, and AI content features from code. It provides both synchronous and asynchronous clients built on httpx and pydantic, with automatic retry logic, pagination support, and typed responses.

The library handles authentication via API token, manages HTTP concerns like timeouts and retries (default 2 retries on 408/429/5xx), and exposes Intercom's resources through method chains (e.g., `client.ai_content.create_content_import_source()`). It supports Python 3.8 through 3.12 and allows customization of the underlying httpx client for proxies or custom transports.

Use it for:

• Automate customer communication workflows by creating and managing conversations or content imports programmatically.
• Build async applications that query Intercom customer data without blocking.
• Integrate Intercom into backend services with built-in retry and timeout handling for reliable API calls.
• Access paginated Intercom resources and iterate through results as generators.
• Monitor or sync Intercom data into external systems using typed response objects.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Intercom API, providing synchronous and asynchronous access to Intercom's messaging, customer data, and AI content management endpoints.

Yes. The package is actively maintained, has low install friction, supports Python 3.8 through 3.12, and provides both sync and async clients with sensible defaults (retries, timeouts, pagination). No known vulnerabilities and reasonable download volume suggest production use. License status is unclear, so verify the repository's license terms before use.

Install

python-intercom on PyPI

pip install python-intercom

uv add python-intercom

poetry add python-intercom

Installing python-intercom

Before you install

Low friction installation with four lightweight runtime dependencies (httpx, pydantic, pydantic-core, typing_extensions). Actively maintained with recent commits and no known vulnerabilities.

Quickstart

pip install python-intercom

from intercom import Intercom

client = Intercom(token="YOUR_TOKEN")
client.ai_content.create_content_import_source(url="https://www.example.com")

Requires a valid Intercom API token for authentication.

Verify before relying

• Exact scope of Intercom API coverage (which endpoints/resources are implemented)
• Whether retry behavior and timeout defaults suit typical Intercom workloads
• Production readiness and stability guarantees beyond active maintenance status
• License terms and conditions for use in proprietary projects

Package facts

Evidence: python_intercom-5.0.1-py3-none-any.whl

Tags

More Python Modules packages