Overview

Getting Started

Widgets

Categories

Keywords

Reviews

Users

Businesses

Businesses Search

Negotiations

Messages

Requests

Help

Changelog

Terms and Policies

Testing your Thumbtack Business Integration

Learn our recommendation for testing a full Business Integration.
Thumbtack provides access to a staging environment as part of onboarding into Thumbtack's developer program. This environment mirrors the Thumbtack product experience from both the customer and pro side, which allows end-to-end testing of your integrations.
  1. Navigate to the Staging Partner Website (https://staging-partner.thumbtack.com/). When accessing the Staging Partner Website, you will be prompted for a username and password. Use the Staging credentials provided to you by your Account Manager.
  2. On the Staging partner website, sign up as a Customer account by clicking the Sign up link at the top right or by navigating to https://staging-partner.thumbtack.com/register.
  3. Once you finish Registering, sign out of your Customer account.
  4. Now, sign up as a Pro by clicking the Join as a pro button (or by navigating to https://staging-partner.thumbtack.com/pro) on the top right.
    We recommend that you create more than one Business under this Pro account so you can test flows that involve Pros with more than one Business.
    1. You'll be requested to provide a phone number. This must be a valid phone number.
    2. You'll be requested to add a credit card, but you can use any placeholder number.
    3. You'll be requested for a SSN. You can use any SSN so long as it is exactly 9 characters, does not start with 666, does not start with 9, does not consist of a single repeated digit (111-11-1111), and does not consist of sequential digits (123-45-6789).
    4. Take note of the zip code and category you set for your Business, as these are required in Step 9. If you forget to, you can view them at https://staging-partner.thumbtack.com/services.
  5. Add a Review to your Business by navigating to the Reviews page from the dropdown at the top right or by navigating to https://staging-partner.thumbtack.com/profile/reviews.
    Write a Review by clicking the Ask for reviews button and then clicking Copy shareable link. You will need to open this link a new Private window (as you are unable to write a review for yourself!).
  6. On your Platform, initiate and complete the OAuth 2.0 Flow to link your newly-created Pro on Thumbtack with a Pro on your Platform.
  7. For each Business in your newly created Pro account, create a Business Webhook to listen for certain eventTypes.
  8. Return to the Staging Partner Website and sign in again with the Customer account you created in Step 2.
  9. Search for the Business you created in Step 4, ensuring the zip code and category match. From there, you can interact with the test Business as a real Customer would, initiating a Negotiation and Messaging.