Retell AI home page
Search...
⌘K
Ask AI
Homepage
Support
Compliance
Dashboard
Dashboard
Search...
Navigation
Keys
API Key Overview
Documentation
API Reference
Video Tutorials
Deprecation Notice
Community
Changelog
Status
Pricing
Enterprise Plan
Introduction
Get Started
Build your first phone agent in 5 minutes
SDKs
Build
Setup conversation flow agent
Setup single / multi prompt agent
Create chat agent
Set language for your agent
Understand user speech better
Generate better responses from LLM
Customize the synthesized speech
Integrate telephony features
Provide context to the agent
Test
Testing Overview
LLM Playground
LLM Simulation Testing
Audio Testing
Deploy
Purchase phone number
Connect to custom telephony providers via SIP
Make & receive phone calls
Create Chat Completion
Retell Chat Widget
Enable SMS capabilities
Setup versioning for agents
Batch Calls
Increase call pickup rate
Connect to web call
Understand concurrency & limits
Monitor
Monitor sessions via dashboard
Get analytics insight
Register & handle webhooks
Post Call Analysis
Reliability & Debugging
Reliability Overview
Latency
Fix agent behaviors
Debug phone call issues
Accounts and Workspace
Workspace
Account
Billing
Keys
API Key Overview
Manage API Keys
Public Keys
Privacy
Advanced Topics
Custom LLM
Audio Basics
Network Ecosystem
Partner Program
Affiliate Program
On this page
REST API Authentication
Webhook API Key
Keys
API Key Overview
API keys are used to authenticate your requests to:
REST API endpoints
SDK integrations
Webhook endpoints
Each workspace can have multiple API keys, all sharing the same permission level.
REST API Authentication
To authenticate your REST API requests, include your API key in the request headers:
Copy
Ask AI
Authorization
:
Bearer YOUR_API_KEY
Try out authentication in our
API Playground
to see it in action.
Webhook API Key
For enhanced security, we automatically designate one of your API keys for
webhook authentication
. This designated webhook API key:
Is used to sign and verify webhook requests
Cannot be deleted
Ensures your webhook endpoints only receive legitimate requests
Keep your API keys secure and never share them in public repositories or client-side code.
Was this page helpful?
Yes
No
Handle failed payments
Manage API Keys
Assistant
Responses are generated using AI and may contain mistakes.