Overview

Getting Started

MARKETPLACE

Widgets

MCP Server

Find Pros

Categories

Keywords

Requests

Leads

Messages

On-Demand Orders

Reviews

User Accounts

Testing Your Marketplace Integration

PRO INTEGRATIONS

Leads

Messages

Reviews

Pro Profiles

Business Phone Numbers

Manage Webhooks

Testing Your Pro Integration

Support

Changelog

Terms and Policies

Manage Webhooks in Thumbtack

Create and manage webhooks for leads, messages, and reviews directly from your Thumbtack account — no integration required.

Ready to set up a webhook?

Go to your Thumbtack account to create, edit, pause, or delete webhooks. Get Started.

Need help getting started? See the step-by-step guide in the Help Center.

What this is

Set up webhooks yourself from inside Thumbtack — create, edit, pause, and delete — for these event families:
  • Leads (negotiation*) — new leads
  • Messages (message*) — incoming customer messages
  • Reviews (review*) — new reviews from customers
This is the simplest path if you want real-time events delivered to a tool you already use — no developer required, no API integration, no OAuth.

Manage in Thumbtack vs. API

Manage in Thumbtack
API integration
Best for
Setting up webhooks for your own business, or one you've hired a dev to wire up
Partners onboarding many pros at scale
Effort
None — set up in the UI
Build and maintain an integration
Pros covered
One Thumbtack business at a time
Unlimited, via OAuth
Events
Leads, messages, reviews
All event types
Auth
Your Thumbtack account
OAuth2 partner credentials
Both paths can run side-by-side — managing webhooks here won't block partner-managed webhooks set up via the API for the same business.

When to use the API instead

Switch to the Pro Profiles webhooks API if you need any of:
  • Webhooks across many pros, managed centrally by your platform
  • Event types beyond leads, messages, and reviews
  • Programmatic create / update / delete (CI/CD, infra-as-code)
  • Webhook auth managed by your system rather than the pro

Delivery and retries

  • Thumbtack sends each event as an HTTPS POST and waits up to 5 seconds for a response. Return a 2XX status to confirm you received it.
  • If your endpoint returns a 5XX status or doesn't respond in time, Thumbtack retries the delivery a limited number of times. 4XX and 3XX responses are not retried, and redirects are not followed.
  • The same event can arrive more than once. Use the ID in the payload to skip duplicates, such as data.negotiationID for leads.
  • Requests are not signed, and Thumbtack doesn't publish a list of IP addresses. To check that a request came from Thumbtack, set Basic Auth or a custom header on the webhook.

Last Updated: Oct 26th, 2026