Testing your integration with the Thumbtack API

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.

Important note for testers located outside of the United States

Thumbtack is currently only accessible from devices located in the United States. If you're testing an integration and are located outside of the United States, you will need to utilize a VPN tunneled to a United States address in order to test.

Partner staging homepage
  1. Navigate to the staging partner website. This requires authentication with the staging credentials provided to you when you signed up with the Thumbtack developer program.
  2. On the staging partner website, sign up as a customer account by clicking the sign up button at the top right (see the screenshot above).
  3. Once you finish onboarding, sign out of your customer account.
  4. Now, sign up as a pro by clicking the join as a pro button on the top right. We recommend that you create more than one business under the account, so you can test flows that involve pros with more than one business.
  5. You'll be requested to add a credit card, but you can use any placeholder number. Take note of the zip codes and category you set for your business, as these are required in step 5.
  6. Add a review to the business by navigating to the reviews page from the dropdown at the top right, and writing a review using the the link from the "ask for reviews" button.
  7. In your partner product, initiate and complete the OAuth 2.0 flow to connect the businesses in your newly created pro account and create webhooks.
  8. Sign in again with the customer account you created in step 2.
  9. Search for the business you created in step 3, ensuring the zip code and category match. From there, you can interact with the test business as a real customer would, initiating a lead and  messaging.