In order to set up your API Integration with Angi, you will need to have the following information gathered:
Your account's Company ID.
This is not always the same as your Service Provider ID that you see next to your company name in the Angi for Pros site.
You can find your Company ID in the URL of your desktop Angi for Pros site, on the top right of your Angi Ads Agreement, labeled SPID, 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)
Authentication Type (key or no key)
Data Format (most commonly JSON, but your CRM contact will know for sure)
The Standard Lead API Requirements that will be needed for set up are shown here in more detail. Angi_Standard_Lead_API_Requirements1.pdf
Once you have this information gathered, you can start the setup for your API Integration, using the steps below:
Log into the Angi for Pros site on your desktop.
Once logged in, open a new tab in your browser and type in the following URL:
https://office.angi.com/app/webhooks/XXXXXX/leads/configure
Note: The area where you see XXXXXX in the URL is where you will place your Company ID from the information gathered above. For example, if your account's Company ID is 123456, the URL should be -https://office.angi.com/app/webhooks/123456/leads/configure
Once you've typed in that URL, you should see this screen, where you will click Get Started.
From here, fill in the blanks on the Edit Configuration page with the information you gathered in the first section above, then click Next. Remember, you should still be logged into your Angi Ads Business Center during this setup process.
Note: If your Authentication Type requires a key, a second drop-down will appear to ask you to type in the key. Please do not share this key in chat or via email, as it is a private security key for your company only.
Now it is time to test your configuration. Click on Send Test Lead in the middle of the page. A blue box should appear at the top of your screen confirming that test lead was successfully sent to your URL.
Once you receive the confirmation box, click Next at the bottom of the screen.
If you do not receive the confirmation box below, please take a screenshot of the message you received for troubleshooting purposes and feel free to start a chat with us for assistance!
You're almost done! Click the Save and Activate button at the bottom of the screen to complete the integration process.
You're all finished, and your integration has been completed. From here you can close out of this tab. Your webhook will receive a copy of each new lead as it is generated! If you have more than one account that needs to be set up, just follow all of the steps again, making sure you are logged into the account you are setting up, and be sure to replace the Company ID in the URL in Step 2.
If you received an error message during the setup or are having trouble with the steps above, you can start a new chat during business hours, and one of our Support Specialists will be able to assist! Our office hours are Monday - Friday 8AM to 9PM and Saturday 9AM to 6PM Eastern.