Reception API quickstart
This guide provisions one customer end to end with the Reception API: a workspace on a paid plan, a business profile for the receptionist to answer from, and a phone number that rings it.
Prerequisites
- An API key from the reseller admin panel, set as
ELEVENLABS_API_KEY. The admin panel is open to Reception.ai partners only; to become one, contact our sales team. - A card on file for your reseller account. Subscribing a workspace charges it.
- The Python SDK (
pip install elevenlabs) or the TypeScript SDK (npm install @elevenlabs/elevenlabs-js).
Provision a customer
Create the workspace
Create the customer’s workspace, subscribe it to a paid tier, and invite the business owner. Invites are best-effort: each one’s result is in member_results.
Omit subscription to create a workspace without a plan and assign one later.
Describe the business
The receptionist answers from the business profile. From here on, every call acts on the new workspace, so it carries the xi-workspace-id header. Days in operating_hours run from 0 (Monday) to 6 (Sunday), and a day with no entry is closed.
Services, staff, locations and holidays are added the same way, with the services, staff, locations and holidays groups.
Next steps
- Provisioning and onboarding: more examples for creating workspaces and describing the business.
- Subscriptions and billing: change the customer’s plan and follow what your card is charged.