Get Started in 5 Minutes
1
Sign In
Sign in at topcalls.ai. New to TopCalls? Book a call and we set up your account.
2
Get Your API Key
Open Settings > Company and create a key in the API keys section. Tick the
calls:write scope, since new keys don’t include it. Copy the key.3
Make Your First Call
Run the example below with
YOUR_API_KEY replaced by your key.Example: Simple Appointment Reminder
Response
The phone rings within seconds, so use a
phone_number you can answer.This call goes out from the platform’s default number. To show your own caller ID, add from_number. It must be an active or verified number on your account, or the call is refused with 422 (from_number_not_owned).What Happens Next?
- Queued: the request is validated and the call is dialed.
- Connected: the phone rings a few seconds later.
- Conversation: the agent works through your
task. - Completed: if you set a webhook, it receives the transcript and summary.
Check Call Status
Next Steps
Customize Your Agent
Control your agent’s personality, voice, and behavior.
Setup Webhooks
Get a webhook when a call finishes, fails or is cancelled.
Use Cases
Examples for appointments, support, sales and collections.
API Reference
Every endpoint, with examples you can run.
Need Help?
- Documentation: Core Concepts
- Contact: Email us at hello@topcalls.ai
- Get Your Deployment Plan: Book a discovery call for a free consultation