Thumbtack · OAuth Scopes

Thumbtack OAuth Scopes

OAuth 2.0 searched

Thumbtack publishes 21 OAuth 2.0 scopes via the authorizationCode and clientCredentials flows. Scopes are the fine-grained permissions an application requests at authorization time to act against the Thumbtack API on a user’s behalf.

Tokens are issued from https://api.thumbtack.com/v4/oauth/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

Local ServicesMarketplaceHome ServicesLeadsPartner API

Scopes: 21 Flows: authorizationCode, clientCredentials Method: searched

OAuth endpoints

Authorization URL
https://www.thumbtack.com/services/partner-connect/

Token URL
https://api.thumbtack.com/v4/oauth/token https://pro-api.thumbtack.com/v2/tokens/access

Flows
authorizationCodeclientCredentials

Scopes (21)

Scope	Description	Flows
demand::messages.read	Read access to messages (Demand API v4, authorization code flow).
demand::messages.write	Write access to messages (Demand API v4, authorization code flow).
demand::negotiations.read	Read access to negotiations (Demand API v4, authorization code flow).
demand::users.read	Read access to user information (Demand API v4, authorization code flow).
demand::users.disconnect	Disconnect access to user and revoke tokens (Demand API v4, authorization code flow).
demand::webhooks.read	Read access to user webhooks (Demand API v4, authorization code flow).
demand::webhooks.write	Write access to user webhooks (Demand API v4, authorization code flow).
demand::orders.read	Read access to on-demand orders (Demand API v4, client credentials flow).
demand::orders.write	Write access to on-demand orders (Demand API v4, client credentials flow).
demand::orders/availability.read	Read access to supply availability for on-demand orders (Demand API v4, client credentials flow).
demand::categories.read	Read access to categories (Demand API v4, client credentials flow).
demand::keywords.read	Read access to keywords (Demand API v4, client credentials flow).
messages	Pro API scope allowing partners to send messages on behalf of pros to customers for given leads via the Messages endpoints.
availability	Pro API scope for accessing pro availability functionality.
bookings	Pro API scope for accessing bookings functionality.
targeting	Pro API scope for managing a pro's targeting preferences for services and categories (service-based and category-based targeting endpoints).
openid	Required OpenID Connect scope; always returns sub (user ID) plus standard claims (iss, aud, exp, iat, at_hash).
profile	Optional OpenID Connect scope returning the user's name, given_name, family_name, picture, and zoneinfo.
email	Optional OpenID Connect scope returning the user's email and email_verified status.
phone	Optional OpenID Connect scope returning the user's phone_number.
offline_access	When included in the scope list for the authorization code flow, Thumbtack's authorization server issues a refresh_token alongside the access_token.

📄 Provider scope reference: https://developers.thumbtack.com/docs/getting-started/authentication

Source

OAuth Scopes

generated: '2026-07-11'
method: searched
source: openapi/thumbtack-demand-openapi.yml, openapi/thumbtack-pro-openapi.yml
docs: https://developers.thumbtack.com/docs/getting-started/authentication
schemes:
- name: oauth2
  source: openapi/thumbtack-demand-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.thumbtack.com/services/partner-connect/
    tokenUrl: https://api.thumbtack.com/v4/oauth/token
  - flow: clientCredentials
    tokenUrl: https://api.thumbtack.com/v4/oauth/token
  description: Used by v4 routes. Authorization Code and Client Credentials flows.
- name: oauth2
  source: openapi/thumbtack-pro-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.thumbtack.com/services/partner-connect/
    tokenUrl: https://pro-api.thumbtack.com/v2/tokens/access
  description: Bearer token obtained via the partner-connect authorization code flow.
scopes:
- scope: demand::messages.read
  description: Read access to messages (Demand API v4, authorization code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::messages.write
  description: Write access to messages (Demand API v4, authorization code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::negotiations.read
  description: Read access to negotiations (Demand API v4, authorization code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::users.read
  description: Read access to user information (Demand API v4, authorization code
    flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::users.disconnect
  description: Disconnect access to user and revoke tokens (Demand API v4, authorization
    code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::webhooks.read
  description: Read access to user webhooks (Demand API v4, authorization code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::webhooks.write
  description: Write access to user webhooks (Demand API v4, authorization code flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::orders.read
  description: Read access to on-demand orders (Demand API v4, client credentials
    flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::orders.write
  description: Write access to on-demand orders (Demand API v4, client credentials
    flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::orders/availability.read
  description: Read access to supply availability for on-demand orders (Demand API
    v4, client credentials flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::categories.read
  description: Read access to categories (Demand API v4, client credentials flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: demand::keywords.read
  description: Read access to keywords (Demand API v4, client credentials flow).
  sources:
  - https://api.thumbtack.com/docs/demand_api.html
- scope: messages
  description: Pro API scope allowing partners to send messages on behalf of pros
    to customers for given leads via the Messages endpoints.
  sources:
  - https://pro-api.thumbtack.com/docs/
- scope: availability
  description: Pro API scope for accessing pro availability functionality.
  sources:
  - https://pro-api.thumbtack.com/docs/
- scope: bookings
  description: Pro API scope for accessing bookings functionality.
  sources:
  - https://pro-api.thumbtack.com/docs/
- scope: targeting
  description: Pro API scope for managing a pro's targeting preferences for services
    and categories (service-based and category-based targeting endpoints).
  sources:
  - https://pro-api.thumbtack.com/docs/
- scope: openid
  description: Required OpenID Connect scope; always returns sub (user ID) plus standard
    claims (iss, aud, exp, iat, at_hash).
  sources:
  - https://developers.thumbtack.com/docs/getting-started/authentication
- scope: profile
  description: Optional OpenID Connect scope returning the user's name, given_name,
    family_name, picture, and zoneinfo.
  sources:
  - https://developers.thumbtack.com/docs/getting-started/authentication
- scope: email
  description: Optional OpenID Connect scope returning the user's email and email_verified
    status.
  sources:
  - https://developers.thumbtack.com/docs/getting-started/authentication
- scope: phone
  description: Optional OpenID Connect scope returning the user's phone_number.
  sources:
  - https://developers.thumbtack.com/docs/getting-started/authentication
- scope: offline_access
  description: When included in the scope list for the authorization code flow, Thumbtack's
    authorization server issues a refresh_token alongside the access_token.
  sources:
  - https://developers.thumbtack.com/docs/getting-started/authentication
note: "Clients are provisioned either purely demand:: or purely supply:: prefixed
  scopes, never a mix; per-route required scopes are listed in the API Reference
  (https://developers.thumbtack.com/docs/getting-started/authentication)."

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This scope set

curl "https://apis.io/api/v1/scopes/thumbtack-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.