For Developers

Request Access
Back to guides

Migrating your existing integration over to the V4 API


In order to migrate from your existing integration to Thumbtack’s V4 API:
  1. You must reach out to the Partnerships team to request developer access for our V4 API platform here. We will issue you a brand new client ID and secret. Your existing client ID and secret WILL NOT work with our V4 APIs nor will the new client ID and secret work with our legacy APIs and endpoints. 
  2. Update your existing business logic to adhere to the new schemas for our V4 endpoints and webhooks. V4 API documentation can be found here. Note that the existing endpoints/webhooks and our V4 equivalents are not backwards compatible. You will also need to implement the new OAuth flow for users to connect with. Please refer to the guide here on steps to implement the OAuth flow.
  3. Existing users already connected to the existing integration will be required to disconnect the integration and reconnect with the new OAuth flow in order to establish a V4 OAuth connection.

NOTE: We will deprecate our V3 legacy endpoints some time in the future, so it is imperative that existing partners work on migrating their existing integrations with Thumbtack over to our V4 API platform in a timely manner to ensure that their integrations stay up and running.