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 [phone]:

https://pbx.yourdomain.com/api/v2/abc123xyz/makecall/101/[phone]

RingQ will ring extension 101. When the agent answers, it will automatically dial [phone] and connect the two parties.

Response

A successful request returns HTTP 200 with a JSON body:

{ "result": "success" }

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

Use URL encoding for destination numbers containing +. Replace + with %2B — e.g. %2B447911123456.