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,
  "spotted_keywords": "buy,quote",
  "lead_score": 50,
  "lead_state": "Completed",
  "profile": "My Profile",
  "profile_id": 51497,
  "account": "My Account",
  "account_id": 27313,
  "lead_url": "https://www.whatconverts.com/contact",
  "landing_url": "https://www.whatconverts.com/",
  "operating_system": "iOS 12",
  "browser": "Chrome Mobile 71",
  "device_type": "Smartphone",
  "device_make": "Apple iPhone",
  "lead_source": "google",
  "lead_medium": "cpc",
  "lead_campaign": "lead generation",
  "lead_content": "new ad",
  "lead_keyword": "generating leads",
  "ip_address": "107.210.21.188",
  "notes": "This is a new lead!",
  "contact_name": "Jeremy Helms",
  "contact_company_name": "Call Tracking Company",
  "contact_email_address": "[email protected]",
  "contact_phone_number": "+17044695324",
  "email_address": "[email protected]",
  "phone_number": "+17044695324",
  "field_mappings": {
    "Company Name": "Call Tracking Company",
    "Contact Person": "Jeremy Helms",
    "Email": "[email protected]",
    "Phone Number": "(704) 469-5324"
  },
  "gclid": "CLibmtmqpNICFcSfGwodQbUAvg",
  "msclkid": "25d83debf85f146b8f1d66a754c6a56c",
  "unbounce_page_id": "f8e32bbc-e1a1-2c5b-b4d3-c6289c8e33b",
  "unbounce_variant_id": "b",
  "unbounce_visitor_id": "107.210.21.1881565955056416071",
  "salesforce_user_id": "15228103840",
  "roistat_visit_id": "wqeOuWjfeIUQdd122casdLK",
  "hubspot_visitor_id": "5a72d290d2d21865a693f14bcf710fed",
  "facebook_browser_id": "fb.1.1621529626600.927228660",
  "facebook_click_id": "fb.1.1621529626598.IwAR1yDeb6_5RRDGD3fTthh9cPoaqhLYYyDFLN-LolvQwaMAPMhGRljDj-POc",
  "google_analytics_client_id": "1017418163.1594157791",
  "vwo_account_id": "512835",
  "vwo_experiment_id": "2",
  "vwo_variant_id": "2",
  "vwo_user_id": "D4A14C3EFD6DB2A51749E1A931BE96B44",
  "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.

• Phone Call
• Phone Call (Modified)
• Phone Call (In Progress)
• Text Message
• Web Form
• Transaction
• Custom Event
• Chat
• Chat (In Progress)
• Email

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": "update",
  "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,
  "spotted_keywords": "buy,quote",
  "lead_score": 50,
  "lead_state": "Completed",
  "profile": "My Profile",
  "profile_id": 51497,
  "account": "My Account",
  "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",
  "notes": "This is a new lead!",
  "contact_name": "Jeremy Helms",
  "contact_company_name": "Call Tracking Company",
  "contact_email_address": "[email protected]",
  "contact_phone_number": "+17044695324",
  "email_address": "[email protected]",
  "phone_number": "+17044695324",
  "field_mappings": {
    "Company Name": "Call Tracking Company",
    "Contact Person": "Jeremy Helms",
    "Email": "[email protected]",
    "Phone Number": "(704) 469-5324"
  },
  "gclid": "CLibmtmqpNICFcSfGwodQbUAvg",
  "msclkid": "25d83debf85f146b8f1d66a754c6a56c",
  "unbounce_page_id": "f8e32bbc-e1a1-2c5b-b4d3-c6289c8e33b",
  "unbounce_variant_id": "b",
  "unbounce_visitor_id": "107.210.21.1881565955056416071",
  "salesforce_user_id": "15228103840",
  "roistat_visit_id": "wqeOuWjfeIUQdd122casdLK",
  "hubspot_visitor_id": "5a72d290d2d21865a693f14bcf710fed",
  "facebook_browser_id": "fb.1.1621529626600.927228660",
  "facebook_click_id": "fb.1.1621529626598.IwAR1yDeb6_5RRDGD3fTthh9cPoaqhLYYyDFLN-LolvQwaMAPMhGRljDj-POc",
  "google_analytics_client_id": "1017418163.1594157791",
  "vwo_account_id": "512835",
  "vwo_experiment_id": "2",
  "vwo_variant_id": "2",
  "vwo_user_id": "D4A14C3EFD6DB2A51749E1A931BE96B44",
  "duplicate": false,
  "spam": false
}