Testing Your Pro Integration

Test your pro integration in Thumbtack's staging environment.

This guide shows you how to create test accounts, receive leads through webhooks, exchange messages, and confirm that your integration works as expected.

Steps

1. Access the staging environment
Go to staging-partner.thumbtack.com and enter the staging credentials from your Account Manager.

2. Create a customer account
Sign up from the top right or go to /register. This account will submit the test request.

3. Create a pro account
Sign out, then create a pro account. Click Join as a pro and complete the signup flow. We recommend creating more than one business under this account to test multi-business flows.

Test card number: 4242 4242 4242 4242

SSN: Any valid 9-digit number that does not start with 666 or 9, is not a repeated digit, and is not sequential

Phone number: Use a valid phone number

Save the zip code and category you choose. You'll need them later to find the pro from the customer account. If you forget, check /services in your pro account.

4. Add a review (optional)
Go to your profile page and click Ask for reviews → Copy shareable link. Open the link in a private window to leave a test review.

5. Connect through OAuth
On your platform, start the OAuth 2.0 flow to connect the test pro to your system.

6. Create a webhook for each business
Use the API to create a webhook for each test business:

POST /api/v4/businesses/{{businessID}}/webhooks
Authorization: Bearer {{access_token}}
Content-Type: application/json
{
  "webhookURL": "https://your-app.com/webhooks/thumbtack",
  "eventTypes": ["NegotiationCreatedV4", "MessageCreatedV4"],
  "enabled": true,
  "auth": {
    "username": "your-username",
    "password": "your-password"
  }
}

You can use webhook.site to create a test endpoint quickly.

7. Submit a request as the customer
Sign back in as the customer. Search for the pro using the same zip code and category, then submit a project request.

8. Confirm the lead arrives
Check your webhook endpoint. You should see a NegotiationCreatedV4 event. Then fetch the full lead details:

GET /api/v4/negotiations/{{negotiationID}}
Authorization: Bearer {{access_token}}

Send a message as the customer and confirm that you also receive a MessageCreatedV4 event at your webhook endpoint.

What success looks like

After you complete these steps, you should see:

A NegotiationCreatedV4 event at your webhook endpoint with the lead details
A successful response from GET /api/v4/negotiations/{negotiationID}
If you subscribe to message events, a MessageCreatedV4 event when either party sends a message

If something isn't working, check the troubleshooting sections in the Leads or Messages implementation guides.

Last Updated: May 1st, 2026

On this page

Testing Your Pro Integration

Steps

What success looks like