Skip to main content
Use this section to build and manage Retell AI voice and chat agents programmatically.

​
What you can do

  • Create, update, and manage calls and chats
  • Configure voice agents and chat agents
  • Manage phone numbers, voices, and knowledge bases
  • Run tests and retrieve test run results
  • Integrate custom telephony and custom LLM workflows

​
Base URL

All REST API requests use the same base URL:
Append the endpoint path from the reference (for example, POST https://api.retellai.com/v2/list-calls). The audio WebSocket uses a separate host — see Audio WebSocket.

​
Authentication

Every request must include your API key as a bearer token in the Authorization header:
Create and manage keys from the API Keys tab in the dashboard. See Manage API Keys for details.

​
SDKs

Official SDKs handle the base URL and authentication for you: See SDKs for installation, initialization, and usage examples.

​
Getting started

If you are new to the API:
  1. Create your API key in the dashboard.
  2. Make your first request with the Create phone call endpoint.
  3. Use the grouped endpoint sections in the sidebar to expand your integration.