How to Safely Update Webhook Destination in Production

You want to change your Destination's URL but you are also afraid of the risk of dropping webhooks.

In this tutorial, we will learn how to take advantage of the pausing of a webhook connection to safely change a Destination's URL.

**This tutorial is also applicable for any scenario that cause your server to have downtime. **

What is Pausing

When a webhook connection is paused, Hookdeck keeps the webhooks on hold and queues them. Once the webhook connection is unpaused, Hookdeck delivers them safely following the destination's delivery rate.

Tutorial

Tutorial example

In this example, I am receiving webhooks from GitHub which are sent to two Destinations (Actions and Deploy). I want to change my endpoint for Actions without running the risk of dropping a webhook.

Pausing a webhook connection

1. Select the connection
2. Click "Pause" button

Update Destination's endpoint

Notice your webhook related to the connection is on hold. You can safely start a server update or change endpoints without being concerned about dropping a webhook.

Let's update the Destination's URL and then click Save.

Unpause webhook connection

1. Select the connection
2. Click "Unpause" button

Great! My webhooks from github → actions that were on hold are being delivered and processed.

Now you know how to take advantage of the Pause feature!