Skip to main content

​
Server SDKs

Build backend integrations with type-safe SDKs.

Python

Type-safe Python library with async support

TypeScript

Full TypeScript support with autocomplete

​
Getting Your API Key

Before using the SDKs, you’ll need an API key from your itellicoAI dashboard.
1

Navigate to Developers

Go to your itellicoAI dashboard and navigate to Developers from the sidebar.
2

Go to API Keys

Click on API Keys in the Developers section.
3

Create your key

Click the Create API Key button in the top-right corner.
API Keys dashboard showing how to create a new API key
API Keys dashboard showing how to create a new API key
4

Copy and use with your SDK

Copy the generated API key and store it securely. Use this key when initializing the SDK.
Never share your API key or commit it to version control. Use environment variables to store your key securely.

​
Why Use SDKs?

Type Safety

Full TypeScript definitions and Python type hints for all API methods

Simplified Auth

Built-in API key management—no manual headers needed

Better Errors

Structured exceptions for easier debugging

Less Code

Clean methods instead of manual HTTP requests

​
Quick Comparison

​
Creating an Agent

from itellicoai import Itellicoai

# Initialize client
client = Itellicoai(
    api_key="your-api-key"
)

# Create an agent
agent = client.agents.create(
    account_id="your-account-id",
    name="Customer Support Agent",
    model={
        "provider": "openai",
        "model": "gpt-4o-mini"
    },
    voice={
        "provider": "elevenlabs",
        "voice_id": "EXAVITQu4vr4xnSDxMaL"
    },
    transcriber={
        "provider": "deepgram",
        "model": "nova-2:general",
        "language": "en-US"
    },
    initial_message={
        "mode": "fixed_message",
        "message": "Hello! How can I assist you today?",
        "delay_ms": 1000
    },
    max_duration_seconds=1800,
    tags=["support", "customer-service"]
)

print(f"Created agent: {agent.id}")

​
Installation

pip install itellicoai
View Python SDK docs →

​
Resources

NPM Package

Install TypeScript SDK from NPM

PyPI Package

Install Python SDK from PyPI

TypeScript SDK

View TypeScript SDK source code

Python SDK

View Python SDK source code

REST API Reference

Complete REST API documentation

OpenAPI Spec

OpenAPI specification file