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

# Direct Call

> Use the RingQ API Web Hook to directly call a number from a specific extension without requiring the agent to dial — ideal for click-to-call integrations.

The Direct Call web hook tells RingQ to dial a destination number on behalf of a specific extension. Unlike Make Call, Direct Call places the outbound leg immediately — the agent's extension rings as if they had dialled the number themselves.

## Prerequisites

Before you begin, you need your **API Key** from the RingQ admin dashboard.

1. Log in to the RingQ admin dashboard.
2. Go to **Settings** → **API**.
3. Copy the **API Key** shown on this page. You will use it in every web hook URL.

## API URL Format

```
https://{your-ringq-domain}/api/v2/{api-key}/directcall/{extension}/{destination}
```

| Parameter           | Description                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------- |
| `your-ringq-domain` | The domain or IP address of your RingQ instance (e.g. `pbx.yourdomain.com`).                            |
| `api-key`           | Your API key from Settings → API.                                                                       |
| `extension`         | The extension number that will be used as the caller (the outgoing call is placed from this extension). |
| `destination`       | The number to dial — an extension, DID, or external phone number.                                       |

## Example

To place a direct outbound call from extension **205** to **+61391234567**:

```
https://pbx.yourdomain.com/api/v2/abc123xyz/directcall/205/+61391234567
```

RingQ will immediately initiate an outbound call from extension 205 to the destination number.

## Response

A successful request returns HTTP `200` with a JSON body:

```json theme={null}
{ "result": "success" }
```

<Tip>Direct Call is ideal for click-to-call buttons in a CRM. When a user clicks the button, the web hook fires, and their desk phone or softphone rings to connect them to the customer.</Tip>