For Developers

Request Access
Back to guides

Implementing the Thumbtack messaging API

Thumbtack’s messaging APIs expose a real time two way webhook based API to integrate Thumbtack into your customer acquisition workflows. This guide outlines the steps to implement our messaging API. The flow from a customer contacting a pro is referred to as a negotiation.
  1. Thumbtack’s API’s utilize the OAuth 2.0 protocol. Complete implementing the authentication and authorization flow such that you may obtain the tokens needed to interact with our APIs.
  2. In your product, you will receive the tokens needed to establish a secure connection with Thumbtack when the user completes the OAuth flow.
  4. 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.
  5. 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.