Get your Thumbtack leads and charges through an API

What you can build on Thumbtack

• Get new leads

  Build this

  Reads the leads in the For you tab on your Jobs page: who contacted you, for which service, where, and the answers they gave about the project.

  Takes

  Business profile (optional), received since (optional)

  Returns

  Customer name, service, city, ZIP code, project details, received date

• List conversations by job status

  Build this

  Reads your Messages, filtered with the Folders menu, and returns each conversation with its job status, such as Not scheduled yet, Scheduled, Job done or No hire.

  Takes

  Job status (optional)

  Returns

  Customer name, service, job status, last message date

• Get lead charges from payment history

  Build this

  Reads the Activity tab of your payment history: the pending and completed charges for each direct lead, booking or opportunity, with any discount applied.

  Takes

  From date, to date

  Returns

  Date, customer name, type, charge, discount, charge status

• Update a job's status

  Build this

  Opens the conversation with a customer in Messages and sets the job status in the drop-down under the customer's name.

  Takes

  Customer name, job status

  Returns

  Customer name, previous job status, new job status

Automate Thumbtack with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Conversations still Not scheduled yet, every morning

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  List the conversations in Messages with the job status Not scheduled yet.

  Step 2

  Group them by service.

  Step 3

  Email you the list with customer name, service and last message date.

• Last week's lead charges, sent to your accounting system

  Build this

  Starts

  Every Monday at 8:00, after the weekly budget resets

  Step 1

  Get the charges in payment history from last Monday to Sunday.

  Step 2

  Total them by type: direct lead, booking and opportunity.

  Step 3

  Post each charge and the totals to your accounting system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get new leads” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.thumbtack.com/get_new_leads",
    "input": {
      "received_since": "2026-11-11"
    }
  }'

{
  "status": "completed",
  "data": {
    "leads": [
      {
        "customer_name": "Jordan M.",
        "service": "Kitchen Remodel",
        "city": "San Francisco",
        "zip_code": "94117",
        "project_details": [
          {
            "question": "Project scope",
            "answer": "Full kitchen renovation"
          }
        ],
        "received_at": "2026-11-11T16:42:00Z"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

Thumbtack’s own options

Thumbtack's API is its Partner Platform: software companies request access and connect pros through OAuth2 to read leads, messages, reviews and profiles. A single business can instead create webhooks in its own account that send new leads, messages and reviews to another tool. They are one-way: you still sign in to Thumbtack to reply.

Read on November 12, 2026: Thumbtack Partner Platform overview, Manage webhooks in Thumbtack, How to create a webhook.

Signing in to Thumbtack

On the website, Thumbtack signs you in with your email address and password, or with a magic link sent to your email that expires after 30 minutes. Google, Apple and Facebook accounts work too. With Fous you sign in once through Thumbtack's own sign-in with your own account: the login is sealed with AES-256, sign-in links are handled, and an expired session is signed back in.

Worth knowing

Your budget resets on Monday

The lead that takes you past your weekly budget is charged in full, going over by at most 40% of the budget or $40 plus 2% of it, whichever is less. Then no new leads come until Monday.

Opportunities are charged separately

Sending a quote to an Opportunity is free, and you are charged only if the customer responds. That cost sits outside your weekly budget, so count it on its own.

Webhooks go one way, per business profile

A webhook sends lead details, messages and reviews out, but cannot reply. Each business profile needs its own, and leads carry the customer's name and phone number, not an email address.

A refund does not send a new event

Thumbtack's Partner Platform sends a lead event once, when the lead is created, and lists no event for later status changes or refunds. Build a weekly charge report from payment history, not from webhook events.

More in Trades, field service and facilities

• Travis Perkins
• GreenSky merchant portal
• CorrigoPro
• Housecall Pro
• Gas Safe Register online services
• Frontdoor Contractor Portal
• LennoxPros
• Carrier Enterprise
• Johnstone Supply
• PowerClerk
• Angi Pro
• Checkatrade
• HD Supply
• Ferguson
• Reece maX
• XactAnalysis
• SRS Roof Hub
• GC ONLINE PLUS
• Enphase Installer Platform
• Bunnings PowerPass

Other industries: Workday supplier portal, Sage Intacct, 微信公众平台, Auto Integrate, ACV Auctions, The Work Number.