Webhooks v2 will become the new default version

Manuel Oliveira

What’s changing?

From March 17, 2025, all new webhooks created via API will be version 2.0 by default. Until further notice, legacy v1 webhooks can still be created by specifying the version parameter in the API request body.

Why is it changing?

We introduced webhooks v2 at the beginning of 2023 to add reliability and stability by reducing duplicate and missing webhook triggers and delays. In addition, lead webhooks are supported in v2. Webhooks v2 have proven their maturity and it is time to start sunsetting v1.

I'm using webhooks v1, do I need to migrate to the new version?

Yes. Webhooks v2 and v1 will continue to run in parallel for now, but v1 will be deprecated entirely before the end of 2025. Please review the v1 to v2 migration guide closely, as there are significant differences in webhooks v2’s payload.