Managing Webhooks

You can create and manage webhooks within Flex. With the appropriate permissions, click "Manage" at the top right, then "Webhooks" in the main menu.

From here, you can:

• Register a new webhook
• Update an existing webhook
• Temporarily deactivate (and reactivate) a webhook
• Delete a webhook
• Rotate a webhook secret

When creating or updating a webhook, specify the destination URL. This URL must use TLS and should be unique for the given webhook and optional filter expression.

Filters

Filters let you discard webhook requests you do not want to receive. They are optional and defined using JSONata expressions. The UI evaluates your expression in real-time against an example payload, so you can verify the outcome as you edit either the expression or the payload.

Secret Key

When you create a webhook, its secret key (used for Signature Verification) is shown once. Copy it somewhere secure before ending the process.

You can rotate the secret key at any time. The new key takes effect almost immediately, but you do not need to synchronise the change at the destination instantly: failed webhook deliveries are retried, so once your destination is updated, pending webhooks will be processed successfully.