Skip to navigation

Reception API

Create and manage your customers' Reception.ai workspaces from your own systems.

The Reception API lets a Reception.ai reseller do in code what the reseller admin panel does by hand: create a workspace for each customer, sell it one of your plans, set up its receptionist, and follow what your card is charged. Every endpoint lives under https://api.elevenlabs.io/v1/reception and is available in the Python and TypeScript SDKs as reception.

The reseller admin panel, and with it the Reception API, is open to Reception.ai partners only. If you’re interested in partnering with us, contact our sales team.

Authentication

Create an API key in the reseller admin panel. Only keys created there can call the Reception API; any other ElevenLabs API key is rejected with not_a_reseller_api_key. The key is shown once, so store it in a secret manager.

Send the key in the xi-api-key header, or set ELEVENLABS_API_KEY and let the SDK read it.

Reseller and workspace endpoints

The API acts at two levels.

LevelActs onSDK groups
ResellerYour reseller accountworkspaces, tiers, subscriptions, billing
WorkspaceOne customer’s workspace, named in xi-workspace-idbusiness_profile, receptionists, phone_numbers, services, staff, locations, holidays, products, assets, knowledge_sources, team

Workspace endpoints need the xi-workspace-id header, set to the ID of a workspace you created. A request without it, or for a workspace that belongs to another reseller, is rejected. In the SDKs the header is the xi_workspace_id argument in Python and the xiWorkspaceId field in TypeScript.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)
staff = elevenlabs.reception.staff.list(
xi_workspace_id=workspaces.workspaces[0].workspace_id,
)

Pagination

workspaces.list and billing.list_invoices return one page at a time. Pass the next_cursor from a response as cursor to get the next page, and stop when has_more is false.

Rate limits

Limits apply per reseller, across all of its API keys:

RequestsLimit
Reads (GET)600 per minute
Writes (all other methods)120 per minute

A request over the limit returns 429. Wait and retry it.

Next steps

  • Quickstart: create a customer’s workspace and put its receptionist on a phone number.
  • Provisioning and onboarding: examples for creating workspaces in bulk and adding a business’s locations, staff, services and receptionist settings.
  • Subscriptions and billing: change a customer’s plan and see what your card is charged.