For Developers

Request Access
Back to guides

Implementing the Thumbtack leads API

Thumbtack’s leads API is a real-time webhook-based API, that integrates Thumbtack into your customer acquisition workflows. This guide outlines the steps to implement our leads API.
  1. 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.
  2. Utilizing the OAuth credentials, obtain the list of businesses on Thumbtack the user owns. A business object contains the information needed for you to present in your interface the business in question as well as create webhooks. You may optionally implement in your user interface the ability the user to select the business or businesses that you wish to create webhooks for.
  3. Create webhooks for the business or businesses that you selected in step 3. If you implement multiple webhook APIs from Thumbtack, you may choose to utilize the same URL per event type, or separate URLs.