In order to set up your API Integration with Angi, you will need to have the following information gathered:
Your account's Company ID, which you can find in the URL of your desktop Angi for Pros site, on the top right of your Angi Agreement, labeled SPID, your bill, or by reaching out to us in chat.
The email address you would like to connect to your CRM
Your unique webhook URL (provided by your CRM contact)
CRM key or no key
Please make sure your CRM provider can accept our JSON (your CRM contact will know for sure)
The Standard Lead API Requirements that will be needed for set up are shown at the bottom of this article in more detail.
Please note, pros using ServiceTitan will need to complete different steps than above, and should reach out to their Account Manager for more details.
Once you have this information gathered, you can email your endpoint and Angi Leads account number to crmintegrations@angi.com to have your CRM setup completed.
Angi Leads (formerly HomeAdvisor) provides a simple JSON post mechanism for delivering customer leads to a partner endpoint. The attached document outlines the field definitions we send. Currently, we are unable to customize the information we send. Your partner will need to set up their endpoint to accept the feeds/fields as described. Some third-party CRMs have trouble integrating with what we have but we've found that you can use a Zapier webhook as a workable solution.
{ "
name":"Jane Doe"
,"firstName":"Jane"
,"lastName":"Doe"
,"address":"123 Main Street"
,"city":"Denver"
,"stateProvince":"CO"
,"postalCode":"80210"
,"primaryPhone":"3031234567"
,"phoneExt":"1234"
,"secondaryPhone":"3037654321"
,"secondaryPhoneExt":"5678"
,"email":"janedoe@gmail.com"
,"srOid":123456789
,"leadOid":987654321
,"fee":25.67
,"taskName":"Moving Out-of-State"
,"comments":"I am moving my family of 4 to a new state. We have a 3 bedroom
house worth of stuff and looking for more information about your moving
services."
,"matchType":"Lead"
,"leadDescription":"Standard"
,"spEntityId":12345678
,"spCompanyName":"Standard Company Name"
,”contactStatus”:”New Appt - Transferred”
, "primaryPhoneDetails": {
"maskedNumber": false,
}
,”crmKey”:”abcd-12345”
,"leadSource":"HomeAdvisor"
,"trustedFormUrl":"https://cert.trustedform.com/xxz1z51db5ed50eb17992be2686166f4
fc87f11c"
,"interview":[
{"question":"What type of moving help do you need?"
,"answer":"Out of state"}
,{"question":"When do you want the pro to begin work?"
,"answer":"More than 2 weeks"}
,{"question":"What zip code are you moving to?"
,"answer":"84044"}
,{"question":"What zip code are you moving from?"
,"answer":"80210"}
,{"question":"When is your moving date?"
,"answer":"8/11/2024"}
]
}
Lead Post Request With Appointment and With Masked Number
{ "
name":"Jane Doe"
,"firstName":"Jane"
,"lastName":"Doe"
,"address":"123 Main Street"
,"city":"Denver"
,"stateProvince":"CO"
,"postalCode":"80210"
,"primaryPhone":"3031234567"
,"phoneExt":"1234"
,"secondaryPhone":"3037654321"
,"secondaryPhoneExt":"5678"
,"email":"janedoe@gmail.com"
,"srOid":123456789
,"leadOid":987654321
,"fee":25.67
,"taskName":"Moving Out-of-State"
,"comments":"I am moving my family of 4 to a new state. We have a 3 bedroom
house worth of stuff and looking for more information about your moving
services."
,"matchType":"Lead"
,"leadDescription":"Standard"
,"spEntityId":12345678
,"spCompanyName":"Standard Company Name"
,”contactStatus”:”New Appt - Transferred”
, "primaryPhoneDetails": {
"maskedNumber": true,
"smsEnabled": true,
"expirationDateTime": "2024-11-14T21:39:27.819932Z"
}
,”crmKey”:”abcd-12345”
,"leadSource":"HomeAdvisor"
,"trustedFormUrl":"https://cert.trustedform.com/xxz1z51db5ed50eb17992be2686166f4
fc87f11c"
,"interview":[
{"question":"What type of moving help do you need?"
,"answer":"Out of state"}
,{"question":"When do you want the pro to begin work?"
,"answer":"More than 2 weeks"}
,{"question":"What zip code are you moving to?"
,"answer":"84044"}
,{"question":"What zip code are you moving from?"
,"answer":"80210"}
,{"question":"When is your moving date?"
,"answer":"8/11/2024"}
]
,”appointment”:{
"appointmentOid":8668
,"status":"Confirmed"
,"type":"Service"
,"start":"2024-06-09T12:00:00.000-07:00"
,"end":"2024-06-09T14:00:00.000-07:00"
,"external_id":"HA-b97290e2-1441-466a-abb3-e2fda9a94cbc.ics"
}
}
Response Example
{
"status":"success"
}