Reception API
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.
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.
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:
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.