V2 Webhooks

What are V2 Webhooks and when will they be available?

V2 Webhooks is our next-generation event notification platform, tentatively scheduled for release in Summer 2025. It offers improved performance, enhanced security through HMAC verification, a self-service interface to manage event subscriptions for your app, a more robust retry mechanism for handling failed deliveries, and closer alignment of the payload data models with our APIs.

What will happen to V1 Webhooks available on docs.servicetitan.com?

The V1 Webhooks platform will be deprecated by 3/31/2026. If you are using V1 Webhooks currently, you should migrate to V2 Webhooks by 3/31/2026 to avoid any disruptions.

I am currently subscribed to V1 Webhooks. What is the impact?

Technically no impact. However, the V1 Webhooks platform will be deprecated by 3/31/2026. If you are using V1 Webhooks currently, you should migrate to V2 Webhooks by 3/3/1/2026 to avoid any disruptions.

Does ServiceTitan offer webhook retries if event delivery fails?

Yes. If your system does not return an HTTP 200 response, the ServiceTitan platform treats it as a failed delivery and will automatically retry sending the notification at intervals of 10, 30, 60, and 300 seconds.

Note: If your system is unavailable for more than 300 seconds, these events can be manually replayed through the developer portal. You’ll be able to view a list of failed events within a selected time period and replay them as needed. This failed events screen is currently under development and is expected to be available by the end of Fall 2025.

Is using HMAC key mandatory or optional?

While using HMAC is optional, we strongly recommend enabling it to secure your webhook integration. HMAC allows you to verify that webhook events are genuinely sent by ServiceTitan and have not been tampered with in transit. This helps protect against spoofed or malicious requests and ensures the integrity of your data. Adding HMAC verification is a simple but powerful way to safeguard your system.

I have an existing app. How can I subscribe my app to the new V2 webhooks?

After logging into Developer Portal, go to Create and Manage Applications, click the Edit icon for your app, click the Add Webhook Events button, and select from the available events.

Once you have saved the changes, a new app version with the selected webhook events will be generated. The customer (tenant admin) should approve the new version from the ServiceTitan → Settings → Integrations → API Application Access page. Once done, ServiceTitan will start transmitting the events to your callback URL on a per tenant ID basis.