Managing webhook configuration

You can manage the webhook from the Integrations page under Webhook configuration. Bokko lets you set the destination URL, view whether the webhook is active, rotate the secret, and deactivate the configuration when you want to stop deliveries.

Set up the webhook for the first time

1. Open Integrations in the dashboard.
2. Go to Webhook configuration and click the setup button.
3. Enter the destination URL.
4. Save the configuration.

When the webhook is created for the first time, Bokko generates a webhook secret and shows it once in a separate dialog. Copy and store that secret securely before closing the dialog.

Edit or reactivate the URL

If a webhook configuration already exists, you can edit the URL from the same section. If the webhook was inactive, saving the URL again reactivates it.

Rotate the secret

1. Open the existing webhook configuration.
2. Click Rotate secret.
3. Confirm the action.
4. Copy the newly generated secret from the show-once dialog and update your receiver.

Secret rotation does not delete the webhook configuration itself. It replaces the secret value, so your receiving system must start using the new secret immediately.

Deactivate the webhook

1. Open the webhook configuration card.
2. Click Deactivate.
3. Confirm the action.

Deactivation is a soft stop. The saved configuration stays in Bokko, so you can later edit the URL and reactivate it instead of building the setup from scratch again.

What the status badges mean