> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first AI phone call in under 5 minutes.

## Get Started in 5 Minutes

This guide will help you make your first AI phone call.

<Steps>
  <Step title="Sign In">
    Sign in at [topcalls.ai](https://www.topcalls.ai/auth/sign-in). New to TopCalls? [Book a call](https://cal.com/topcalls.ai/30min) and we set up your account.
  </Step>

  <Step title="Get Your API Key">
    Once logged in, navigate to **Settings > API Keys** and create a new key. Copy it for the next step.
  </Step>

  <Step title="Make Your First Call">
    Use the example below to trigger your first AI phone call. Replace `YOUR_API_KEY` with your actual key.
  </Step>
</Steps>

## Example: Simple Appointment Reminder

```bash theme={null}
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 Rachel, a friendly appointment coordinator. Call to confirm John's 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

```json theme={null}
{
  "call_id": "564d4fd4-03bc-400a-abe0-05540fbeff88",
  "status": "queued"
}
```

<Note>
  The call will be placed within seconds. Make sure the `phone_number` is a number you can answer for testing.

  `from_number` is the caller ID the recipient sees. It must be a phone number provisioned for your TopCalls account. Provision one in your dashboard before making calls; if you omit the field, TopCalls falls back to a default sender that is not guaranteed to be the right caller ID for your traffic.
</Note>

## What Happens Next?

1. **Call is Queued**: The system validates your request and queues the call
2. **Call Connects**: Within a few 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 receive a webhook (if configured) with the transcript and summary

## Check Call Status

Use the `call_id` from the response to check the status:

```bash theme={null}
curl https://api.topcalls.ai/v1/calls/564d4fd4-03bc-400a-abe0-05540fbeff88 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Customize Your Agent" icon="robot" href="/concepts/ai-voice">
    Control your agent's personality, voice, and behavior.
  </Card>

  <Card title="Setup Webhooks" icon="webhook" href="/guides/webhooks">
    Receive real-time events when calls start, end, or fail.
  </Card>

  <Card title="Explore Use Cases" icon="lightbulb" href="/use-cases/appointment-reminders">
    See real-world examples for appointments, support, sales, and collections.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Complete REST API documentation with interactive examples.
  </Card>
</CardGroup>

## Need Help?

* **Documentation**: Browse our [Core Concepts](/concepts/overview)
* **Contact**: Email us at [hello@topcalls.ai](mailto:hello@topcalls.ai)
* **Get Your Deployment Plan**: [Book a discovery call](https://cal.com/topcalls.ai/30min) for a free consultation