{"id":10163,"library":"python-intercom","title":"Intercom Python SDK","description":"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.","status":"active","version":"5.0.1","language":"python","source_language":"en","source_url":"https://github.com/intercom/python-intercom","tags":["api-client","sdk","intercom","customer-messaging"],"install":[{"cmd":"pip install python-intercom","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"HTTP client for API requests.","package":"httpx","optional":false},{"reason":"Used for data validation and models (Fern-generated SDKs).","package":"pydantic","optional":false},{"reason":"Date/time parsing and manipulation.","package":"python-dateutil","optional":false},{"reason":"Backports and additions to the typing module.","package":"typing-extensions","optional":false}],"imports":[{"wrong":"from intercom import IntercomClient","symbol":"IntercomClient","correct":"from intercom import IntercomClient"}],"quickstart":{"code":"import os\nfrom intercom_python_sdk import IntercomClient\n\n# Initialize the client with your Personal Access Token\n# Recommended: Store token in an environment variable named INTERCOM_ACCESS_TOKEN\nclient = IntercomClient(personal_access_token=os.environ.get(\"INTERCOM_ACCESS_TOKEN\", \"\"))\n\nif not client.personal_access_token:\n    print(\"Error: INTERCOM_ACCESS_TOKEN environment variable not set.\")\n    print(\"Please set it or pass your token directly to IntercomClient(personal_access_token='YOUR_TOKEN')\")\nelse:\n    try:\n        # Example: List all users\n        users_list = client.users.list_all(per_page=1)\n        if users_list and users_list.data:\n            print(f\"Successfully retrieved {len(users_list.data)} user(s).\")\n            for user in users_list.data:\n                print(f\"  User ID: {user.id}, Email: {user.email}\")\n        else:\n            print(\"No users found or an empty list was returned.\")\n    except Exception as e:\n        print(f\"An error occurred: {e}\")\n","lang":"python","description":"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."},"warnings":[{"fix":"Always install using `pip install python-intercom`. Always import using `from intercom_python_sdk import ...`.","message":"The 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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"Version 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.","severity":"breaking","affected_versions":"4.0.0 and above"},{"fix":"Always use environment variables (e.g., `os.environ.get('INTERCOM_ACCESS_TOKEN')`) to store and retrieve your API token securely.","message":"The client requires a `personal_access_token` for authentication. Direct inclusion in code is discouraged.","severity":"gotcha","affected_versions":"4.0.0 and above"}],"env_vars":null,"search_vec":"'5.0.1':44 'allow':29 'api':27,51,55 'api-cli':54 'autom':50 'client':56 'conveni':20 'convers':34 'current':41 'custom':60 'customer-messag':59 'develop':30 'event':35 'instal':14 'interact':23 'intercom':1,6,13,15,26,58 'manag':32 'messag':61 'name':10 'project':9 'provid':18 'pypi':8 'python':2,5,12,16 'python-intercom':11 'regener':53 'regular':47 'sdk':3,7,17,39,57 'specif':52 'updat':48 'user':33 'version':43 'way':21","created_at":"2026-04-17T01:22:42.553577+00:00","updated_at":"2026-04-17T01:22:42.553577+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'IntercomClient' from 'intercom' (/tmp/tmpwwl3oanp/venv/lib/python3.12/site-packages/intercom/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"5.0.1","cli_name":"","cli_version":null,"type":"library","homepage":"https://www.intercom.com/","github":"https://github.com/intercom/python-intercom","docs":null,"changelog":null,"pypi":"https://pypi.org/project/python-intercom/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication","crm-productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}