Thumbtack
App · 18 actions
Run your Thumbtack pro business from workflows: start one for each new lead, message or review, read leads, message customers, reply to reviews, report job status, and manage webhooks and Thumbtack Numbers.
Actions
| Action | What it does |
|---|---|
| Add phone number | Register a US or Canadian phone number, such as a team member's, so it can call and text the business's customers through Thumbtack Numbers. |
| Create webhook | Have Thumbtack send a business's new leads, messages or reviews to an https address as they happen, optionally protected with a username and password or a secret header. |
| Delete phone number | Remove a registered phone number, so it can no longer reach customers through the business's Thumbtack Numbers. |
| Delete webhook | Delete a webhook so Thumbtack stops sending to its address. |
| Get lead | Get a lead: the customer and their phone number, what they asked for and where, its status (open, canceled or hired), the lead price and any refund. |
| Get signed-in user | Get the Thumbtack user this connection signed in as: name, email and phone number. |
| Get webhook | Get one of a business's webhooks: its address, events and state. |
| List businesses | List the Thumbtack businesses (pro profiles) of the signed-in user, with each one's ID, name and phone number. |
| List messages | List the messages between the customer and the pro on a lead, with who sent each, its text and when. |
| List phone numbers | List the phone numbers registered to call and text customers through a business's Thumbtack Numbers. |
| List reviews | List a business's reviews with the rating, what the customer wrote, the business's reply and the lead each came from. |
| List webhooks | List the addresses a business's new leads, messages or reviews are sent to, with the events each gets and whether it is on. |
| Reply to review | Post the business's public reply to a review on Thumbtack. |
| Send message | Send a message to the customer on a lead, as the pro. |
| Send test lead | Have Thumbtack send a made-up new lead to the business's webhooks, to check they work. |
| Update job status | Tell Thumbtack where a lead's job stands: scheduled, done, paid or canceled. |
| Update phone number | Change a registered phone number or its name. |
| Update webhook | Change a webhook's address or events, or turn it on or off. |
Add phone number
Register a US or Canadian phone number, such as a team member's, so it can call and text the business's customers through Thumbtack Numbers.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number
phone_numbertextRequired - The number, like +14155550100 or (415) 555-0100.
- Name
nametext - Whose number it is, such as a person or a desk.
Outputs
phone_numberobject- The phone number
Example output
{
"phone_number": {
"businessID": "468046965846925323",
"createdTime": "2026-11-03T15:28:05Z",
"isDeleted": false,
"lastActivityTime": "2026-11-03T15:28:05Z",
"name": "Front desk",
"phoneNumber": "+14155550123",
"phoneNumberID": "5343987659230309812",
"updatedTime": "2026-11-03T15:28:05Z"
}
}Create webhook
Have Thumbtack send a business's new leads, messages or reviews to an https address as they happen, optionally protected with a username and password or a secret header.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Address
urltextRequired - The https:// address to send events to.
- Events
event_typeslistRequired - What Thumbtack should send to the address.One or more of:
NegotiationCreatedV4(New lead),MessageCreatedV4(New message),ReviewCreatedV4(New review). - State
statetext - Whether it starts sending at once. Defaults to on.One of:
on(On: send events),off(Off: paused). Default:on. - Username
auth_usernametext - A username Thumbtack signs in to the address with. Give a password too, or leave both empty.
- Password
auth_passwordtext - The password that goes with the username.
- Header name
auth_header_nametext - Instead of a username and password: a header Thumbtack sends with every event, such as X-Api-Key.
- Header value
auth_header_valuetext - The secret value of that header.
Outputs
webhookobject- The webhook
Example output
{
"webhook": {
"authType": "Basic",
"businessID": "468046965846925323",
"enabled": true,
"eventTypes": [
"NegotiationCreatedV4",
"MessageCreatedV4"
],
"webhookID": "129485611932385327",
"webhookURL": "https://example.com/thumbtack"
}
}Delete phone number
Remove a registered phone number, so it can no longer reach customers through the business's Thumbtack Numbers.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number
phone_number_idtextRequired - The registered phone number. Pick one, or give its ID.
Outputs
business_idtext- The business
deletedtrue/false- Always true once deleted
phone_number_idtext- The number deleted
Example output
{
"business_id": "468046965846925323",
"deleted": true,
"phone_number_id": "5343987659230309812"
}Delete webhook
Delete a webhook so Thumbtack stops sending to its address.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook
webhook_idtextRequired - The webhook. Pick one, or give its ID.
Outputs
business_idtext- The business
deletedtrue/false- Always true once deleted
webhook_idtext- The webhook deleted
Example output
{
"business_id": "468046965846925323",
"deleted": true,
"webhook_id": "129485611932385327"
}Get lead
Get a lead: the customer and their phone number, what they asked for and where, its status (open, canceled or hired), the lead price and any refund.
Inputs
- Lead ID
lead_idtextRequired - The lead's ID, from the 'New lead' trigger or an earlier step.
Outputs
leadobject- The lead
Example output
{
"lead": {
"business": {
"accessCode": "4821",
"businessID": "468046965846925323",
"imageURL": "https://production-next-images-cdn.thumbtack.com/i/example.jpeg",
"name": "Robert's Remodeling",
"phoneNumber": "+14155550100"
},
"chargeState": "Charged",
"createdAt": "2026-06-13T17:18:01Z",
"customer": {
"customerID": "519153480034934784",
"firstName": "Olivia",
"lastName": "Young",
"phone": "555-555-5555"
},
"estimate": {
"type": "OnSite"
},
"leadPrice": "$25.00",
"negotiationID": "519153480500518912",
"request": {
"attachments": [],
"category": {
"categoryID": "201565295100608806",
"name": "Kitchen Remodel"
},
"customerID": "519153480034934784",
"description": "Looking to fully renovate my kitchen.",
"details": [
{
"answer": "Full kitchen renovation",
"question": "Project scope"
}
],
"location": {
"address1": "100 Main St",
"address2": "",
"city": "San Francisco",
"state": "CA",
"zipCode": "94117"
},
"requestID": "519153479873802240"
},
"status": "Open"
}
}Get signed-in user
Get the Thumbtack user this connection signed in as: name, email and phone number.
Inputs
None.
Outputs
userobject- The user
Example output
{
"user": {
"email": "robert@example.com",
"firstName": "Robert",
"lastName": "Smith",
"phoneNumber": "+14155550100",
"userID": "286845156044809661"
}
}Get webhook
Get one of a business's webhooks: its address, events and state.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook
webhook_idtextRequired - The webhook. Pick one, or give its ID.
Outputs
webhookobject- The webhook
Example output
{
"webhook": {
"authType": "Basic",
"businessID": "468046965846925323",
"enabled": true,
"eventTypes": [
"NegotiationCreatedV4",
"MessageCreatedV4"
],
"webhookID": "129485611932385327",
"webhookURL": "https://example.com/thumbtack"
}
}List businesses
List the Thumbtack businesses (pro profiles) of the signed-in user, with each one's ID, name and phone number.
Inputs
- Maximum results
max_resultsnumber - How many to return, 1 to 200. Defaults to 20.From 1 to 200.
Outputs
businesseslist- The businesses
countnumber- How many were returned
has_moretrue/false- Whether Thumbtack has more than were returned
Example output
{
"businesses": [
{
"accessCode": "4821",
"businessID": "468046965846925323",
"imageURL": "https://production-next-images-cdn.thumbtack.com/i/example.jpeg",
"name": "Robert's Remodeling",
"phoneNumber": "+14155550100"
}
],
"count": 1,
"has_more": false
}List messages
List the messages between the customer and the pro on a lead, with who sent each, its text and when.
Inputs
- Lead ID
lead_idtextRequired - The lead's ID, from the 'New lead' trigger or an earlier step.
- Sent after
sent_afterdate and time - Only messages sent after this time.
- Sent before
sent_beforedate and time - Only messages sent before this time.
- Maximum results
max_resultsnumber - How many to return, 1 to 200. Defaults to 20.From 1 to 200.
Outputs
countnumber- How many were returned
has_moretrue/false- Whether Thumbtack has more than were returned
messageslist- The messages
Example output
{
"count": 1,
"has_more": false,
"messages": [
{
"attachments": [],
"customer": {
"customerID": "519153480034934784",
"displayName": "Olivia Y."
},
"from": "Customer",
"messageID": "519153481515696128",
"negotiationID": "519153480500518912",
"sentAt": "2026-06-13T17:18:01Z",
"text": "Are you available on my date?"
}
]
}List phone numbers
List the phone numbers registered to call and text customers through a business's Thumbtack Numbers.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
Outputs
countnumber- How many
phone_numberslist- The phone numbers
Example output
{
"count": 1,
"phone_numbers": [
{
"businessID": "468046965846925323",
"createdTime": "2026-11-03T15:28:05Z",
"isDeleted": false,
"lastActivityTime": "2026-11-03T15:28:05Z",
"name": "Front desk",
"phoneNumber": "+14155550123",
"phoneNumberID": "5343987659230309812",
"updatedTime": "2026-11-03T15:28:05Z"
}
]
}List reviews
List a business's reviews with the rating, what the customer wrote, the business's reply and the lead each came from.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Maximum results
max_resultsnumber - How many to return, 1 to 200. Defaults to 20.From 1 to 200.
Outputs
countnumber- How many were returned
has_moretrue/false- Whether Thumbtack has more than were returned
reviewslist- The reviews
Example output
{
"count": 1,
"has_more": false,
"reviews": [
{
"categoryID": "5343987659230309814",
"createTime": "2026-04-02T01:43:49Z",
"images": [],
"negotiationID": "5343987659230309813",
"rating": 5,
"responseText": "Thank you so much for the kind words!",
"responseTime": "2026-04-03T10:00:00Z",
"reviewID": "5343987659230309812",
"reviewText": "Great communication from start to finish.",
"reviewerName": "EB"
}
]
}List webhooks
List the addresses a business's new leads, messages or reviews are sent to, with the events each gets and whether it is on.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Maximum results
max_resultsnumber - How many to return, 1 to 200. Defaults to 20.From 1 to 200.
Outputs
countnumber- How many were returned
has_moretrue/false- Whether Thumbtack has more than were returned
webhookslist- The webhooks
Example output
{
"count": 1,
"has_more": false,
"webhooks": [
{
"authType": "Basic",
"businessID": "468046965846925323",
"enabled": true,
"eventTypes": [
"NegotiationCreatedV4",
"MessageCreatedV4"
],
"webhookID": "129485611932385327",
"webhookURL": "https://example.com/thumbtack"
}
]
}Reply to review
Post the business's public reply to a review on Thumbtack. Everyone who views the business's profile can read it.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Review ID
review_idtextRequired - The review's ID, from 'List reviews' or the 'New review' trigger.
- Reply
response_texttextRequired - The reply to post.
Outputs
business_idtext- The business
respondedtrue/false- Always true once posted
response_texttext- The reply posted
review_idtext- The review
Example output
{
"business_id": "468046965846925323",
"responded": true,
"response_text": "Thank you for your feedback!",
"review_id": "5343987659230309812"
}Send message
Send a message to the customer on a lead, as the pro. It shows in the customer's Thumbtack inbox.
Inputs
- Lead ID
lead_idtextRequired - The lead's ID, from the 'New lead' trigger or an earlier step.
- Message
texttextRequired - What to say to the customer.
Outputs
messageobject- The message sent
Example output
{
"message": {
"attachments": [],
"business": {
"businessID": "468046965846925323",
"displayName": "Robert's Remodeling"
},
"from": "Business",
"messageID": "519153481515696128",
"negotiationID": "519153480500518912",
"sentAt": "2026-06-13T17:18:01Z",
"text": "Thanks for reaching out! I can come by Tuesday."
}
}Send test lead
Have Thumbtack send a made-up new lead to the business's webhooks, to check they work. No real lead is created.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
Outputs
business_idtext- The business
senttrue/false- Always true once sent
Example output
{
"business_id": "468046965846925323",
"sent": true
}Update job status
Tell Thumbtack where a lead's job stands: scheduled, done, paid or canceled. Done and paid jobs count as hires on the pro's Thumbtack dashboard.
Inputs
- Lead ID
lead_idtextRequired - The lead's ID, from the 'New lead' trigger or an earlier step.
- Job status
statustextRequired - Where the job stands now.One of:
not_scheduled(Not scheduled yet),appt_scheduled(Job or estimate scheduled),job_complete(Job done),invoice_paid(Job done and invoice paid),customer_cancel(Canceled by the customer),pro_cancel(Canceled by the pro). - Changed at
changed_atdate and time - When the job reached this status. Leave empty for now.
- Invoice amount ($)
invoice_amountnumber - What the customer was invoiced, in dollars.Only when Job status is Job done or Job done and invoice paid. At least 0.
Outputs
changed_attext- When it changed
invoice_amount_in_centsnumber- The invoice amount sent, in cents
lead_idtext- The lead
statustext- The status sent
updatedtrue/false- Always true once sent
Example output
{
"changed_at": "2026-06-14T09:30:00Z",
"invoice_amount_in_cents": 125000,
"lead_id": "519153480500518912",
"status": "job_complete",
"updated": true
}Update phone number
Change a registered phone number or its name. Fields left empty keep their values.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number
phone_number_idtextRequired - The registered phone number. Pick one, or give its ID.
- New number
phone_numbertext - The new number. Leave empty to keep it.
- Name
nametext - A new name. Leave empty to keep it.
Outputs
phone_numberobject- The phone number
Example output
{
"phone_number": {
"businessID": "468046965846925323",
"createdTime": "2026-11-03T15:28:05Z",
"isDeleted": false,
"lastActivityTime": "2026-11-03T15:28:05Z",
"name": "Office",
"phoneNumber": "+14155550123",
"phoneNumberID": "5343987659230309812",
"updatedTime": "2026-11-03T15:28:05Z"
}
}Update webhook
Change a webhook's address or events, or turn it on or off. Fields left empty keep their values.
Inputs
- Business
business_idtextRequired - The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook
webhook_idtextRequired - The webhook. Pick one, or give its ID.
- Address
urltext - A new https:// address. Leave empty to keep it.
- Events
event_typeslist - The events to send instead. Leave empty to keep them.One or more of:
NegotiationCreatedV4(New lead),MessageCreatedV4(New message),ReviewCreatedV4(New review). - State
statetext - Turn it on or off. Leave empty to keep it as it is.One of:
on(On: send events),off(Off: paused).
Outputs
webhookobject- The webhook
Example output
{
"webhook": {
"authType": "Basic",
"businessID": "468046965846925323",
"enabled": false,
"eventTypes": [
"NegotiationCreatedV4",
"MessageCreatedV4"
],
"webhookID": "129485611932385327",
"webhookURL": "https://example.com/thumbtack"
}
}