# Place a call through your trunk

`POST /v1/provisioning/tenants/{tenant_id}/calls`

Dial `destination` with one of your agents over your trunk. `tenant_id` is your setup ID — the `_id` from Get your account.

## Auth

Authentication required.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tenant_id | path | yes | string | Your setup ID — the `_id` returned by `GET /me`. |

## Request body

Required: yes
Content-Type: application/json
Shape: ProvisioningOutboundCallRequest

| Name | Type | Required | Description |
|---|---|---|---|
| destination | string | yes | At least 1 characters. |
| agent_id | string | yes | At least 1 characters. |
| path | enum(pbx \| pstn) \| null | no |  |
| metadata | object | no | Default {}. |

## Responses

| Status | Description | Content-Type | Shape |
|---|---|---|---|
| 200 | Successful Response | application/json | unknown |
| 422 | Validation Error | application/json | HTTPValidationError |

## Machine-readable

This page is also available as Markdown at `/docs/post-v1-provisioning-tenants-tenant_id-calls.md` (the ".md" suffix convention). The full curated API contract is at `/api/openapi.json`, and a machine-readable index of every page is at `/llms.txt`.
