# Thumbtack

> 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.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/thumbtack

## Actions

### 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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number (`phone_number`, text, required): The number, like +14155550100 or (415) 555-0100.
- Name (`name`, text): Whose number it is, such as a person or a desk.

**Outputs**

- `phone_number` (object): The phone number

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Address (`url`, text, required): The https:// address to send events to.
- Events (`event_types`, list, required): What Thumbtack should send to the address. One or more of: `NegotiationCreatedV4` (New lead), `MessageCreatedV4` (New message), `ReviewCreatedV4` (New review).
- State (`state`, text): Whether it starts sending at once. Defaults to on. One of: `on` (On: send events), `off` (Off: paused). Default: `on`.
- Username (`auth_username`, text): A username Thumbtack signs in to the address with. Give a password too, or leave both empty.
- Password (`auth_password`, text): The password that goes with the username.
- Header name (`auth_header_name`, text): Instead of a username and password: a header Thumbtack sends with every event, such as X-Api-Key.
- Header value (`auth_header_value`, text): The secret value of that header.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number (`phone_number_id`, text, required): The registered phone number. Pick one, or give its ID.

**Outputs**

- `business_id` (text): The business
- `deleted` (true/false): Always true once deleted
- `phone_number_id` (text): The number deleted

**Example output**

```json
{
  "business_id": "468046965846925323",
  "deleted": true,
  "phone_number_id": "5343987659230309812"
}
```

### Delete webhook

Delete a webhook so Thumbtack stops sending to its address.

**Inputs**

- Business (`business_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its ID.

**Outputs**

- `business_id` (text): The business
- `deleted` (true/false): Always true once deleted
- `webhook_id` (text): The webhook deleted

**Example output**

```json
{
  "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_id`, text, required): The lead's ID, from the 'New lead' trigger or an earlier step.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "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**

- `user` (object): The user

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its ID.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "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_results`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `businesses` (list): The businesses
- `count` (number): How many were returned
- `has_more` (true/false): Whether Thumbtack has more than were returned

**Example output**

```json
{
  "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_id`, text, required): The lead's ID, from the 'New lead' trigger or an earlier step.
- Sent after (`sent_after`, date and time): Only messages sent after this time.
- Sent before (`sent_before`, date and time): Only messages sent before this time.
- Maximum results (`max_results`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `count` (number): How many were returned
- `has_more` (true/false): Whether Thumbtack has more than were returned
- `messages` (list): The messages

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.

**Outputs**

- `count` (number): How many
- `phone_numbers` (list): The phone numbers

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Maximum results (`max_results`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `count` (number): How many were returned
- `has_more` (true/false): Whether Thumbtack has more than were returned
- `reviews` (list): The reviews

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Maximum results (`max_results`, number): How many to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `count` (number): How many were returned
- `has_more` (true/false): Whether Thumbtack has more than were returned
- `webhooks` (list): The webhooks

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Review ID (`review_id`, text, required): The review's ID, from 'List reviews' or the 'New review' trigger.
- Reply (`response_text`, text, required): The reply to post.

**Outputs**

- `business_id` (text): The business
- `responded` (true/false): Always true once posted
- `response_text` (text): The reply posted
- `review_id` (text): The review

**Example output**

```json
{
  "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_id`, text, required): The lead's ID, from the 'New lead' trigger or an earlier step.
- Message (`text`, text, required): What to say to the customer.

**Outputs**

- `message` (object): The message sent

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.

**Outputs**

- `business_id` (text): The business
- `sent` (true/false): Always true once sent

**Example output**

```json
{
  "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_id`, text, required): The lead's ID, from the 'New lead' trigger or an earlier step.
- Job status (`status`, text, required): 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_at`, date and time): When the job reached this status. Leave empty for now.
- Invoice amount ($) (`invoice_amount`, number): 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_at` (text): When it changed
- `invoice_amount_in_cents` (number): The invoice amount sent, in cents
- `lead_id` (text): The lead
- `status` (text): The status sent
- `updated` (true/false): Always true once sent

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Phone number (`phone_number_id`, text, required): The registered phone number. Pick one, or give its ID.
- New number (`phone_number`, text): The new number. Leave empty to keep it.
- Name (`name`, text): A new name. Leave empty to keep it.

**Outputs**

- `phone_number` (object): The phone number

**Example output**

```json
{
  "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_id`, text, required): The Thumbtack business (pro profile). Pick one, or give its ID.
- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its ID.
- Address (`url`, text): A new https:// address. Leave empty to keep it.
- Events (`event_types`, list): The events to send instead. Leave empty to keep them. One or more of: `NegotiationCreatedV4` (New lead), `MessageCreatedV4` (New message), `ReviewCreatedV4` (New review).
- State (`state`, text): Turn it on or off. Leave empty to keep it as it is. One of: `on` (On: send events), `off` (Off: paused).

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "webhook": {
    "authType": "Basic",
    "businessID": "468046965846925323",
    "enabled": false,
    "eventTypes": [
      "NegotiationCreatedV4",
      "MessageCreatedV4"
    ],
    "webhookID": "129485611932385327",
    "webhookURL": "https://example.com/thumbtack"
  }
}
```
