Webhooks

This feature is available for the Calls & Texts Essentials plan and higher, as well as for Forms Essentials plans. Use our help article to see or change your pricing.

 

Available Requests

For a full overview of the webhooks offered, read our Developer Documentation.

Alternatively, if you're using a third-party tool to track visitors via cookies, you can use Webhooks to associate visitor data with phone calls to your CallRail numbers and form submissions. This data would appear on your caller's timelines after configuring our Custom Cookie Capture integration.

Use this article to learn more about Custom Cookie Capture.

Example Request

  POST "/?datetime=2012-08-22+20%3A44%3A43&trackingnum=%2B14047773734&callernum=%2B17451187568&destinationnum=4041234567&callsource=disabled&callername=Olivia+Rodriguez&keywords=&referrer=&referrermedium=&landingpage=&recording=https%3A%2F%app.callrail.com%2Fcalls%2F197479887%2Frecording%2Fc9ad534a44ee2b426c4e&answered=true&duration=291&first_call=true"

JSON Body:
{
  "datetime": "2013-02-05 16:14:43",
  "trackingnum": "+14047773734",
  "callernum": "+17451187568",
  "destinationnum": "4041234567",
  "callsource": "disabled",
  "callername": "Olivia Rodriguez",
  "keywords": "",
  "referrer": "",
  "referrermedium": "",
  "landingpage": "",
  "recording": "https://app.callrail.com/calls/247716205/recording/1b6d7d5f0c54f2e2ed4b",
  "answered": true,
  "duration": "157",
  "first_call": true
}

Security Keys for Webhooks

CallRail generates a secret, random token for every company. You can find each company's key viewed on the webhooks configuration page outlined in the next section. The token is used with the request payload to generate a hash signature that is passed as a request header in the webhook request. You can use the secret token on your server to recompute the same hash based on the request payload. If your computed signature matches the header that CallRail sends, the request is valid.

How to Use Advanced Security Settings

Adding a Webhook to CallRail

  1. Click Settings at the top of the page.

  2. Choose the company you’d like to create a webhook.

  3. Select All Integrations from the Integrations menu on the left.

  4. Choose Webhooks from the list of available integrations.

  5. Find the webhook you'd like to use, and enter your endpoint.

  6. Select Activate when finished.

Disabling Webhooks

Disabling a company's webhooks will prevent CallRail from sending your data to your third-party integrations. We'll keep your webhooks saved in case you'd like to re-activate your integration in the future.

  1. Click Settings at the top of the page.

  2. Choose the company whose webhooks you'd like to disable.

  3. Select All Integrations from the Integrations menu on the left.

  4. Choose Webhooks from the list of integrations.

  5. Select Disable Integration on the right side of the page.

  6. Click Disable to turn off your webhooks integration.

Comments