> ## 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.

# Make Call

> Use the RingQ API Web Hook to initiate a call between two extensions or numbers programmatically — trigger calls directly from your CRM, website, or custom application.

The Make Call web hook instructs RingQ to place a call from one extension to another number. RingQ calls the source extension first, and once answered, connects it to the destination.

## 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}/makecall/{source}/{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.                                                   |
| `source`            | The extension number to call first (the agent or user who will pick up).            |
| `destination`       | The number the source will be connected to — an extension, DID, or external number. |

## Example

To have extension **101** call the external number **+447911123456**:

```
https://pbx.yourdomain.com/api/v2/abc123xyz/makecall/101/+447911123456
```

RingQ will ring extension 101. When the agent answers, it will automatically dial +447911123456 and connect the two parties.

## Response

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

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

If the request fails (invalid API key, unreachable extension, etc.), the response will include an error message.

<Tip>Use URL encoding for destination numbers containing `+`. Replace `+` with `%2B` — e.g. `%2B447911123456`.</Tip>