Skip to main content

Webhooks Migration Guide

Deprecation notice

The original Uniform webhooks configuration will be deprecated on 25th April 2023. We will reach out to inform affected users of this change. If you have any concerns then please don’t hesitate to contact us.

Affected Users

This guide is only relevant to users who created webhooks in Uniform before 25th January 2023. If you are new to Uniform, or have not created any webhooks in your project yet, please refer to our documentation on working with Webhooks here.

For users who signed up for the Uniform platform before 18th January, we provided some simple webhook tooling that provides the minimum configuration needed to setup simple webhook integrations such as site rebuilds. The UI for this interface can be seen below;

webhooks-migration-older-ui

Although effective for simple jobs, we quickly understood from our customers that more advanced configuration options would be needed in order to support some key use cases and to verify and authenticate requests.

On the 25th January 2023, we implemented a major update to our webhooks implementation to address some of these gaps. This update adds new functionality to help developers control their webhooks with finer granularity, security, and control. Leveraging tooling from Svix, this update provides:

  • Verification signatures to protect against man-in-the-middle attacks and replay attacks.
  • Better filtering on events and ability to retry or replay events in the event of service downtime.
  • More events to choose from when setting up webhooks, and the ability to turn certain events on/off.

Migrating to the new version of webhooks

Migrating from the old webhooks configuration to the newer version is a straightforward process. First, you will need to obtain the URL you used to setup your original webhooks.

webhooks-migration-copy

Next, you will create a new webhook following the steps in the guide here within the new configuration. If you want to receive the exact same events that were being fired by the original webhook configuration, be sure to check only these boxes during the setup of your new webhook instance:

  • composition.published
  • manifest.published
Important

Once complete, make sure to delete the old webhook configuration in order to ensure that duplicated events are not being fired to your webhook endpoint at the same time.

webhooks-migration-delete

Using the new webhook configuration

To learn more about our new webhook features including setup steps and information on verifying requests, please check out our documentation here.

How to know if the migration is complete?

You will know when the migration process has been completed as the old configuration settings will no longer be present when you visit your project's webhooks settings.

If you are not sure if you have set up your new webhooks instance correctly or are struggling to use our new interface, please don't hesitate to get in touch.