Skip to main content

​
Get Started in 5 Minutes

Welcome to TopCalls—the AI-Powered Outbound Platform for BPO Operations. This guide will help you make your first AI phone call in just a few minutes. Replace manual dialing. Scale without hiring.
1

Create an Account

Sign in at topcalls.ai to get your API key.
2

Get Your API Key

Once logged in, navigate to Settings → API Keys and create a new key. Copy it—you’ll need it for the next step.
3

Make Your First Call

Use the example below to trigger your first AI phone call. Replace YOUR_API_KEY with your actual key.

​
Example: Simple Appointment Reminder

Here’s a complete example that calls a phone number with a friendly appointment reminder. This demonstrates the platform’s capabilities for automating customer interactions: 
curl -X POST https://api.topcalls.ai/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+14155551234",
    "from_number": "+18005551234",
    "task": "You are Sarah, a friendly appointment coordinator. Call to confirm John's dental appointment tomorrow at 3 PM. Be warm, professional, and brief. If they need to reschedule, ask for their preferred time.",
    "voice": "alloy",
    "mode": "realtime"
  }'

​
Response

{
  "call_id": "564d4fd4-03bc-400a-abe0-05540fbeff88",
  "provider_call_id": "64e9bf0e-7c2f-4443-a759-7eb1731cd583",
  "status": "queued"
}
The call will be placed within seconds. Make sure the phone_number is a number you can answer for testing!

​
What Happens Next?

  1. Call is Queued: The system validates your request and queues the call
  2. Call Connects: Within 2-5 seconds, the recipient receives the call
  3. AI Conversation: The AI agent speaks naturally, handles responses, and completes the task
  4. Call Completes: After the call ends, you’ll receive a webhook (if configured) with the transcript and summary

​
Check Call Status

Use the call_id from the response to check the status: 
curl https://api.topcalls.ai/v1/calls/564d4fd4-03bc-400a-abe0-05540fbeff88 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Next Steps

Customize Your Agent

Learn how to write better instructions, use custom voices, and control the AI’s personality.

Setup Webhooks

Receive real-time events when calls start, end, or fail. Perfect for integrating with your systems.

Explore Use Cases

See real-world examples of how companies use TopCalls for appointment reminders, sales, and support.

API Reference

Dive deep into our complete REST API with interactive examples and detailed documentation.

​
Need Help?