# Place an outbound call

> POST /calls/dispatch. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/calls/post-calls-dispatch-place-an-outbound-call

POST https://server.heyrik.com/api/v1/calls/dispatch

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- phone_number_id (string, required): Which of YOUR numbers to call from (GET /phone-numbers).
- to (string, required): Destination in E.164, e.g. +919876543210.
- agent_id (string): Agent to speak. Defaults to the number's assigned agent.
- variables (object): Merged into the prompt — {{name}}, {{order_id}}…

## Notes

Returns as soon as the call is dialling — it does NOT wait for the conversation. Poll GET /calls/{id} for the result.

## Request example

```sh
curl -X POST https://server.heyrik.com/api/v1/calls/dispatch \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "sip_45723ca5",
    "to": "+919876543210",
    "agent_id": "agc_9f2a1c30",
    "variables": { "name": "Ravi", "order_id": "AC-8842" }
  }'
```

## Response example

```json
{ "data": { "call_id": "call_1dd990f7", "status": "dialing" } }
```