Unified.to Python SDK

0.57.42 verified Fri May 01 auth: no python

Python client SDK for Unified.to, a unified API platform that provides a single integration point for over 200 SaaS applications. Current version 0.57.42, requires Python >=3.10, actively maintained with frequent releases.

pip install unified-python-sdk

Common errors

error ImportError: cannot import name 'UnifiedTo' from 'unified_python_sdk' ↓

cause Incorrect import path; the package uses underscore in the module name but the class is named UnifiedTo.

fix

Use: from unified_python_sdk import UnifiedTo

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

cause The SDK removed api_key parameter in version 0.40.0. Now requires client_id and client_secret.

fix

Pass client_id and client_secret instead of api_key.

error AuthenticationError: Invalid client credentials ↓

cause Using environment='production' without proper production credentials (or using wrong client_id/client_secret).

fix

Set environment='sandbox' during development, or ensure client_id and client_secret are correct for production.

Warnings

breaking Client ID and Secret are now required constructor arguments. Previously an API key alone was supported. ↓

fix Pass client_id and client_secret to UnifiedTo() instead of api_key.

deprecated The `api_key` parameter is deprecated and will be removed in a future version. ↓

fix Use client_id and client_secret for authentication.

gotcha You must set the environment to 'sandbox' for testing; default is 'production' and will fail if credentials are not provisioned for production. ↓

fix Provide environment='sandbox' in constructor for development.

gotcha Resource methods return lists, not paginated objects. For large datasets you must handle pagination manually using 'offset' and 'limit' parameters. ↓

fix Check the SDK documentation for pagination: use offset/limit parameters in list calls.

Imports

UnifiedTo

wrong

from unified import UnifiedTo

correct

from unified_python_sdk import UnifiedTo

Package name uses underscores, not hyphens.

UnifiedTo
wrong
```
import unified_python_sdk
```
correct
```
from unified_python_sdk import UnifiedTo
```
Direct import of module does not expose client class; must import the class.

Quickstart

Initialize client with environment variables and fetch available integrations.

from unified_python_sdk import UnifiedTo

client = UnifiedTo(
    client_id=os.environ.get('UNIFIED_CLIENT_ID', ''),
    client_secret=os.environ.get('UNIFIED_CLIENT_SECRET', ''),
    environment=os.environ.get('UNIFIED_ENVIRONMENT', 'sandbox')
)
# Get list of integrations
integrations = client.integration.list()
print(integrations)