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.
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.
You can edit the webhook by clicking on the Edit button next to the webhook you want to edit from the webhooks list.
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. |
Webhooks can be filtered from the webhooks list, by clicking on the Filter button in the top toolbar.
You can regenerate a webhook signing key from the webhooks list, by clicking on the Regenerate Signing Key menu item.
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.