Business Phone Numbers

API mapping: In the Thumbtack API, business phone numbers are called associate-phone-numbers. All endpoints use /api/v4/businesses/{businessID}/associate-phone-numbers/.

What are Thumbtack Numbers?

Thumbtack Numbers are permanent phone numbers (with no expiration date) that let customers and pros communicate while keeping Thumbtack in the loop. They improve customer responsiveness and give Thumbtack better information to help users get more jobs done.

Thumbtack Numbers work like any other phone number and can be saved within FSM tools for ongoing communication with customers.

Before a pro can send or receive calls and texts from Thumbtack Numbers, they must register their business phone numbers using this API.

For full endpoint details, see the Business Associate Phone Numbers API Reference.

Create a phone number

POST /api/v4/businesses/{businessID}/associate-phone-numbers
Authorization: Bearer {{authCode}}
Content-Type: application/json
{
  "phoneNumber": "+1234567890",
  "name": "John Doe's Phone Number"
}

List phone numbers

Retrieve all registered phone numbers for a business:

GET /api/v4/businesses/{businessID}/associate-phone-numbers
Authorization: Bearer {{authCode}}

Response:

{
  "phoneNumbers": [
    {
      "phoneNumberID": "5343987659230309812",
      "businessID": "5343987659230309812",
      "phoneNumber": "+1234567890",
      "createdTime": "2023-11-03T15:28:05Z",
      "updatedTime": "2023-11-03T15:28:05Z",
      "lastActivityTime": "2023-11-03T15:28:05Z",
      "isDeleted": false,
      "name": "John Doe's Phone Number"
    }
  ]
}

Update a phone number

Update the details of an existing phone number:

PUT /api/v4/businesses/{businessID}/associate-phone-numbers/{phoneNumberID}
Authorization: Bearer {{authCode}}
Content-Type: application/json
{
  "phoneNumber": "+1234567890",
  "name": "John Doe's Phone Number"
}

Delete a phone number

Remove a registered phone number from a business:

DELETE /api/v4/businesses/{businessID}/associate-phone-numbers/{phoneNumberID}
Authorization: Bearer {{authCode}}

Bulk create phone numbers

POST /api/v4/businesses/{businessID}/associate-phone-numbers-bulk-create
Authorization: Bearer {{authCode}}
Content-Type: application/json
{
  "phoneNumbers": [
    {
      "phoneNumber": "+1234567890",
      "name": "John Doe's Phone Number"
    },
    {
      "phoneNumber": "+0987654321",
      "name": "Jane Smith's Phone Number"
    }
  ]
}

Last Updated: May 1st, 2026

On this page

Business Phone Numbers

What are Thumbtack Numbers?

Create a phone number

List phone numbers

Update a phone number

Delete a phone number

Bulk create phone numbers

Business Phone Numbers

What are Thumbtack Numbers?

Create a phone number

List phone numbers

Update a phone number

Delete a phone number

Bulk create phone numbers

Related