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

ActionWhat it does
Add phone numberRegister 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 webhookHave 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 numberRemove a registered phone number, so it can no longer reach customers through the business's Thumbtack Numbers.
Delete webhookDelete a webhook so Thumbtack stops sending to its address.
Get leadGet 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 userGet the Thumbtack user this connection signed in as: name, email and phone number.
Get webhookGet one of a business's webhooks: its address, events and state.
List businessesList the Thumbtack businesses (pro profiles) of the signed-in user, with each one's ID, name and phone number.
List messagesList the messages between the customer and the pro on a lead, with who sent each, its text and when.
List phone numbersList the phone numbers registered to call and text customers through a business's Thumbtack Numbers.
List reviewsList a business's reviews with the rating, what the customer wrote, the business's reply and the lead each came from.
List webhooksList 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 reviewPost the business's public reply to a review on Thumbtack.
Send messageSend a message to the customer on a lead, as the pro.
Send test leadHave Thumbtack send a made-up new lead to the business's webhooks, to check they work.
Update job statusTell Thumbtack where a lead's job stands: scheduled, done, paid or canceled.
Update phone numberChange a registered phone number or its name.
Update webhookChange 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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Phone numberphone_numbertextRequired
The number, like +14155550100 or (415) 555-0100.
Namenametext
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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
AddressurltextRequired
The https:// address to send events to.
Eventsevent_typeslistRequired
What Thumbtack should send to the address.One or more of: NegotiationCreatedV4 (New lead), MessageCreatedV4 (New message), ReviewCreatedV4 (New review).
Statestatetext
Whether it starts sending at once. Defaults to on.One of: on (On: send events), off (Off: paused). Default: on.
Usernameauth_usernametext
A username Thumbtack signs in to the address with. Give a password too, or leave both empty.
Passwordauth_passwordtext
The password that goes with the username.
Header nameauth_header_nametext
Instead of a username and password: a header Thumbtack sends with every event, such as X-Api-Key.
Header valueauth_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Phone numberphone_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Webhookwebhook_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 IDlead_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Webhookwebhook_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 resultsmax_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 IDlead_idtextRequired
The lead's ID, from the 'New lead' trigger or an earlier step.
Sent aftersent_afterdate and time
Only messages sent after this time.
Sent beforesent_beforedate and time
Only messages sent before this time.
Maximum resultsmax_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

Businessbusiness_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Maximum resultsmax_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Maximum resultsmax_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Review IDreview_idtextRequired
The review's ID, from 'List reviews' or the 'New review' trigger.
Replyresponse_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 IDlead_idtextRequired
The lead's ID, from the 'New lead' trigger or an earlier step.
MessagetexttextRequired
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

Businessbusiness_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 IDlead_idtextRequired
The lead's ID, from the 'New lead' trigger or an earlier step.
Job statusstatustextRequired
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 atchanged_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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Phone numberphone_number_idtextRequired
The registered phone number. Pick one, or give its ID.
New numberphone_numbertext
The new number. Leave empty to keep it.
Namenametext
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

Businessbusiness_idtextRequired
The Thumbtack business (pro profile). Pick one, or give its ID.
Webhookwebhook_idtextRequired
The webhook. Pick one, or give its ID.
Addressurltext
A new https:// address. Leave empty to keep it.
Eventsevent_typeslist
The events to send instead. Leave empty to keep them.One or more of: NegotiationCreatedV4 (New lead), MessageCreatedV4 (New message), ReviewCreatedV4 (New review).
Statestatetext
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"
  }
}

On this page