Thumbtack’s leads API is a real-time webhook-based API, that integrates Thumbtack into your customer acquisition workflows. You are responsible for creating and managing the webhooks needed to receive leads for a User's business(es) on Thumbtack. This guide outlines the steps to implement our leads API.
- Thumbtack’s APIs utilize the OAuth 2.0 protocol. First, make sure you implement the authentication and authorization OAuth flow so you can get the tokens needed to interact with our APIs.
- Utilizing the OAuth credentials, obtain the list of businesses on Thumbtack the user owns. By providing access to the list of businesses and the ability to create a webhook for a specific business this allows you the ability to provide a custom interface to allow the user to select which businesses they wish to have their leads sent to your platform for. If you simply wish to have leads sent for all the user's business you can forgo presenting a selection prompt to the user and simply create webhooks for all of their businesses.
- Create webhooks for the business or businesses that you selected in step 2. If you subscribe to multiple webhook event types from Thumbtack, you may choose to utilize the webhook per event type, or separate webhooks.
- Implement handling events over the webhook. Negotiations are Thumbtack leads and are published via the webhook you create for a business. These are sent when a customer contacts a business with a request on Thumbtack.