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

# Make Phone Call

> Initiate an outbound phone call

## Request

```bash theme={null}
curl -X POST https://app.orova.ai/api/optimus/call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "AGENT_ID",
    "phoneNumber": "+1234567890",
    "phoneNumberId": "PHONE_NUMBER_ID",
    "contactName": "John Doe",
    "workspaceId": "WORKSPACE_ID"
  }'
```

## Parameters

| Field           | Type   | Required | Description                                     |
| --------------- | ------ | -------- | ----------------------------------------------- |
| `assistantId`   | string | Yes      | Agent to use for the call                       |
| `phoneNumber`   | string | Yes      | Destination phone number (E.164)                |
| `phoneNumberId` | string | Yes      | Orova phone number to call from                 |
| `contactName`   | string | No       | Contact name for history and variable injection |
| `workspaceId`   | string | Yes      | Workspace ID                                    |

## Response

```json theme={null}
{
  "call_id": "call_abc123",
  "status": "initiated"
}
```

## Notes

* A credit check is performed before the call. Returns `402` if insufficient credits.
* If `contactName` is provided, Orova looks up the contact and injects their data as variables.
* The call is initiated via Twilio. The agent speaks the first message when the recipient answers.