Webhooks


About the UpdaterCloud webhooks

Webhooks allow you to build or set up integrations, such as Zapier integrations, which subscribe to certain events on UpdaterCloud. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL.

{warning} The maximum number of webhooks that can be created depends on your subscription plan.

The webhook signature is provided in the X-UpdaterCloud-Signature request header. This is how the payload signature can be validated in PHP:

$signature = $_SERVER['HTTP_X_UPDATERCLOUD_SIGNATURE'];

$computedSignature = hash_hmac('sha256', $payload, $secret);

if (hash_equals($signature, $computedSignature)) {
    // signature is valid, do stuff
}

The $payload is the received webhook call payload and the $secret is your webhook signing key.

Create webhook

Webhooks can be created by using the New button in the top toolbar, or by duplicating an existing webhook using the Duplicate button next to the webhook you want to duplicate from the webhooks list. The new webhook details will be automatically filled in with the duplicated webhook details.

Edit webhook

You can edit the webhook by clicking on the Edit button next to the webhook you want to edit from the webhooks list.

Webhook details

When creating a new webhook, or editing an existing one, the following fields are available:

Field Required Description
Name Yes We recommend using a unique name for the webhook, so you can recognize it among others.
Destination URL Yes The url where to receive the webhook notification. The url must be secure (HTTPS only).
Signing key No The secret key used to sign this webhook's payload, to make sure it hasn't been tampered with. A secure key will be automatically generated after creating the webhook. Do not share this key with anybody.
Notifications Yes Select the events you wish to receive notifications for.
Publishing status Yes When published, the webhook will be triggered on selected events.

Filter webhooks

Webhooks can be filtered from the webhooks list, by clicking on the Filter button in the top toolbar.

Regenerate webhook signing key

You can regenerate a webhook signing key from the webhooks list, by clicking on the Regenerate Signing Key menu item.

Delete webhook

Webhooks can be deleted from the webhooks list, by clicking on the Delete link next to the webhook you want to delete, or from the webhook editing page.

{danger} Deleted items are not recoverable. This action is permanent and can't be undone.