# Get your Thumbtack leads and charges through an API > Read the leads on your Jobs page, the job status of each conversation in Messages and the charges in your payment history with one API call each. Or have a workflow post last week's lead charges to your accounting system every Monday, when your budget resets. Page: https://fous.com/automate/thumbtack-pro Updated: 2026-11-12 Works with your own Thumbtack Pro account. Fous is an independent product. ## What you can build on Thumbtack ### Get new leads 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 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 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 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](/product/workflows) 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 Starts: Every weekday at 7:00 1. List the conversations in Messages with the job status Not scheduled yet. 2. Group them by service. 3. Email you the list with customer name, service and last message date. ### Last week's lead charges, sent to your accounting system Starts: Every Monday at 8:00, after the weekly budget resets 1. Get the charges in payment history from last Monday to Sunday. 2. Total them by type: direct lead, booking and opportunity. 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](/product/methods), 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. Example request: ``` 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" } }' ``` Example response: ``` { "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. | Option | What it covers | What it takes | | --- | --- | --- | | Partner Platform API | Leads, messages, pro profiles, reviews and business phone numbers for the pros a partner connects. | An approved access request from a company, with OAuth2 client details and redirect URIs. | | Webhooks in Apps, Manage webhooks | Sends new leads (customer name and phone number), messages and reviews to your URL as they happen. One-way. | Free. Set up in a web browser, one per business profile. | | Thumbtack by hand | The Jobs page, Messages and job statuses, Services and your budget, and payment history with Activity and Receipts. | Your Thumbtack pro account. | Read on November 12, 2026: [Thumbtack Partner Platform overview](https://developers.thumbtack.com/docs/overview), [Manage webhooks in Thumbtack](https://developers.thumbtack.com/docs/pro-integrations/self-serve-webhooks), [How to create a webhook](https://help.thumbtack.com/article/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](https://fous.com/automate/travis-perkins.md) - [GreenSky merchant portal](https://fous.com/automate/greensky-merchant-portal.md) - [CorrigoPro](https://fous.com/automate/corrigopro.md) - [Housecall Pro](https://fous.com/automate/housecall-pro.md) - [Gas Safe Register online services](https://fous.com/automate/gas-safe-register-online-services.md) - [Frontdoor Contractor Portal](https://fous.com/automate/frontdoor-contractor-portal.md) - [LennoxPros](https://fous.com/automate/lennoxpros.md) - [Carrier Enterprise](https://fous.com/automate/carrier-enterprise.md) - [Johnstone Supply](https://fous.com/automate/johnstone-supply.md) - [PowerClerk](https://fous.com/automate/powerclerk.md) - [Angi Pro](https://fous.com/automate/angi-pro.md) - [Checkatrade](https://fous.com/automate/checkatrade.md) - [HD Supply](https://fous.com/automate/hd-supply.md) - [Ferguson](https://fous.com/automate/ferguson.md) - [Reece maX](https://fous.com/automate/reece-max.md) - [XactAnalysis](https://fous.com/automate/xactanalysis.md) - [SRS Roof Hub](https://fous.com/automate/srs-roof-hub.md) - [GC ONLINE PLUS](https://fous.com/automate/gc-online-plus.md) - [Enphase Installer Platform](https://fous.com/automate/enphase-installer-platform.md) - [Bunnings PowerPass](https://fous.com/automate/bunnings-powerpass.md) Other industries: [Workday supplier portal](/automate/workday-supplier-portal), [Sage Intacct](/automate/sage-intacct), [微信公众平台](/automate/wechat-official-accounts-platform), [Auto Integrate](/automate/auto-integrate), [ACV Auctions](/automate/acv-auctions), [The Work Number](/automate/the-work-number). ## Frequently asked questions ### Does Thumbtack have an API? Yes, for partner companies. Thumbtack's Partner Platform gives approved partners OAuth2 access to leads, messages, reviews and pro profiles. For your own business, you can create webhooks under Apps, Manage webhooks that send new leads, messages and reviews to a URL, with no integration needed. ### Can I send my Thumbtack leads to another tool? Yes, with a webhook you create in a web browser under Apps, Manage webhooks. Many pros generate the URL in Zapier. Each lead carries the customer's name and phone number, and you test the setup with a test lead that shows in Recent deliveries. ### Where do I see what I paid for each lead? In your payment history. The Activity tab lists pending and completed charges for each direct lead, booking or opportunity, with the cost and any discount. The Receipts tab holds receipts, preloaded balances and prepaid packages. ### Why did I stop getting leads in the middle of the week? Most likely you reached your weekly budget. You then stop appearing in search results until the budget resets on Monday, unless you raise it, which takes effect right away. Lead boosts may still bring discounted leads after the limit. ### Is Fous affiliated with Thumbtack? No. Fous is an independent product. You use it with your own Thumbtack pro account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Thumbtack Pro (Thumbtack). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.