Overview
Getting Started
Widgets
Categories
Keywords
Reviews
Users
Businesses
Businesses Search
Negotiations
Messages
Requests
Help
Changelog
Terms and Policies
Get up and running with our Messages 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.
- 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.
- On your Platform, you will receive the tokens needed to establish a secure connection with Thumbtack when the user completes the OAuth flow.
- Implement the Negotiations API. Messages are associated with a given Negotiation (Lead) by having the same Negotiation ID. This allows you to keep the conversation tied to the specific Lead.
- 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, you can provide a custom interface to allow your 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(es) 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.
On this page