Integrations

  1. Help Center
  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

1In your WhatConverts Dashboard, go to the “Integrations” menu and select “Webhooks” from the menu.

2Click on “Add Webhook“.
3In the new dialog box, add your “Webhook URL” and select the Lead Types and Trigger Type for the Webhook.  
4Click “Add“. 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 common 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",
  "msclkid": "25d83debf85f146b8f1d66a754c6a56c",
  "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 common 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",
  "msclkid": "25d83debf85f146b8f1d66a754c6a56c",
  "salesforce_user_id": "15228103840",
  "duplicate": false,
  "spam": false
}