1. Home
  2. Integrations
  3. Webhooks

Webhooks

A webhook allows you to be notified in real-time when a new lead comes into your account.

Setting up webhooks

In your WhatConverts dashboard head over to the “Integrations” tab and select “Webhooks” from the drop down.  From here you will click on “Add Webhook” which will bring up a new dialog for you to add your “Webhook URL” and select the lead types and trigger type for the webhook.  Once you have done that, hit “Add” you are done.  You can add up to 5 webhooks that will trigger at one time.

Webhook Data

New Lead

When a new lead comes into your account we will send a single POST request as JSON to your webhook URL. Each POST request will have these commons variables.

{
  "trigger": "new",
  "lead_id": 153928,
  "user_id": "51497-af17340d-62b8-3044-423f-3dc754e621c2",
  "lead_type": "Phone Call",
  "lead_status": "Unique",
  "date_created": "2016-02-01T14:09:01Z",
  "quotable": "Not Set",
  "quote_value": null,
  "sales_value": null,
  "profile": "My Profile",
  "profile_id": 51497,
  "account_id": 27313,
  "lead_url": "https://www.whatconverts.com/contact",
  "landing_url": "https://www.whatconverts.com/",
  "lead_source": "google",
  "lead_medium": "cpc",
  "lead_campaign": "lead generation",
  "lead_content": "new ad",
  "lead_keyword": "generating leads",
  "ip_address": "107.210.21.188",
  "gclid": "CLibmtmqpNICFcSfGwodQbUAvg",
  "salesforce_user_id": "15228103840",
  "duplicate": false,
  "spam": false
}

Depending on the type of lead that you receive additional variables will be available. Click below on the type of lead to see example data.

Update Lead

When a lead is updated in your account we will send a single POST request as JSON to your webhook URL. Each POST request will have these commons variables along with the values that have been updated and any additional values based on the lead type.

{
  "trigger": "new",
  "lead_id": 153928,
  "user_id": "51497-af17340d-62b8-3044-423f-3dc754e621c2",
  "lead_type": "Phone Call",
  "lead_status": "Unique",
  "date_created": "2016-02-01T14:09:01Z",
  "quotable": "Not Set",
  "quote_value": null,
  "sales_value": null,
  "profile": "My Profile",
  "profile_id": 51497,
  "account_id": 27313,
  "lead_url": "https://www.whatconverts.com/contact",
  "landing_url": "https://www.whatconverts.com/",
  "lead_source": "google",
  "lead_medium": "cpc",
  "lead_campaign": "lead generation",
  "lead_content": "new ad",
  "lead_keyword": "generating leads",
  "ip_address": "107.210.21.188",
  "gclid": "CLibmtmqpNICFcSfGwodQbUAvg",
  "salesforce_user_id": "15228103840",
  "duplicate": false,
  "spam": false
}