What are "Web Hook" lead notifications?

Every Lead Manager account has the option to communicate lead notifications with a web server whenever a new lead is received. These "Web Hooks" can be used to update external customer relationship management software (CRM), trigger custom notifications, or update an external database.

The payload

When a new lead is matched to your account, we'll POST to your URL with a payload of XML-formatted data about the lead and their request. Here is a sample payload:
<?xml version="1.0" encoding="utf-8"?>
<Lead>
  <FirstName>James</FirstName>
  <LastName>Evans</LastName>
  <Address>3462 Rivendell Drive</Address>
  <City>Youngstown</City>
  <State>OH</State>
  <ZipCode>44509</ZipCode>
  <PhoneNumber>3305556274</PhoneNumber>
  <DirectLeadPhoneNumber>3305556275</DirectLeadPhoneNumber>
  <EmailAddress>james.evans@testdomain.org</EmailAddress>
  <LeadId>0</LeadId>
  <ServiceId>3000</ServiceId>
  <ServiceName>Install or Replace Asphalt Roof</ServiceName>
  <Service>Roofing</Service>
  <TimeFrame>Anytime</TimeFrame>
  <Notes>This is a test webhook notification.</Notes>
  <AdditionalDetails>
    <Detail question="Did you request a test webhook notification?">Yes</Detail>
  </AdditionalDetails>
</Lead>
This is sent as a POST with the Content-Type set to "text/xml".
Note: The PhoneNumber field will contain the Speed-To-Call phone number if you are signed up to receive the Speed-To-Call Discount.  The DirectLeadPhoneNumber field will always contain the lead's actual phone number.

Testing

When you set up your webhook notification, you can send yourself a test from LeadManager.  If you do not receive anything, there is likely a problem with how your webhook endpoint is set up.  Postman is a very useful tool for troubleshooting these sorts of problems.  It can be obtained here for free:  https://www.getpostman.com/
All you need to do to send yourself a test in Postman after downloading it is create a new POST request, put your webhook url in the url field, and paste the above sample in the body of the request.  Ensure that it is being sent as "text/xml" as shown in this screenshot, and click "Send" when you want to receive the request:

Still need help? Contact Us Contact Us