kombo

library1.1.3pypypi✓ verified 84d ago

Official Python SDK for the Kombo Unified API, providing a unified interface to multiple HR, ATS, and other SaaS platforms. Current version: 1.1.3. Release cadence is irregular, roughly monthly.

devops

pip install kombo

INSTALL

IMPORT

SIG · KOMBO

kombo

devopspythonv1.1.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

Kombo

✓ from kombo import Kombo

✗ from kombo.client import Kombo

Kombo is the main client class, directly importable from top-level package since v1.0.0.

models

✓ from kombo import models

✗ from kombo.models import ...

Direct import of models works, but some submodules may not exist.

Initialize client with API key (set KOMBO_API_KEY env var) and list available integrations.

import os from kombo import Kombo client = Kombo(api_key=os.environ.get('KOMBO_API_KEY', '')) # Example: list integrations integrations = client.integrations.list() print(integrations)

Debug

Known issues

breakingThe client constructor changed in v1.0.0 from positional 'api_key' to keyword-only argument.

fix

Use `Kombo(api_key=...)` instead of `Kombo(...)` positional.

affects: >=1.0.0

gotchaAPI key must be provided as string; environment variable is not auto-read. Many users forget to set the key and get 401 errors.

fix

Always pass `api_key` explicitly or set `KOMBO_API_KEY` env var and read it with `os.environ.get('KOMBO_API_KEY')`.

affects: all

deprecatedThe `kombo.models` module is partially deprecated in favor of `kombo.types` as of v1.1.0.

fix

Use `from kombo.types import ...` for type definitions.

affects: >=1.1.0

Errors

Common errors & fixes

kombo.exceptions.AuthenticationError: Invalid API key

API key is missing or incorrect.

fix

Set KOMBO_API_KEY environment variable or pass `api_key` argument to Kombo().

AttributeError: module 'kombo' has no attribute 'client'

Trying to import `kombo.client` which does not exist in recent versions.

fix

Use `from kombo import Kombo` directly.

TypeError: __init__() got an unexpected keyword argument 'api_key'

Using positional argument instead of keyword argument for api_key (possibly old version).

fix

Ensure kombo >=1.0.0 and use `Kombo(api_key=...)`.

Upgrade

Version history

1.1.3latest on PyPI · released May 12, 2026

Audit

Dependencies

requestsrequiredHTTP client for API calls

pydanticrequiredData validation and serialization

Agent activity

4 hits · last 30 days

node

Resources

No resource links recorded.