guideWebhooks management

Webhooks management is available for every environment in the CKEditor Ecosystem customer dashboard for SaaS or in the Management Panel for the On-Premises version.

Webhooks are managed separately for every environment. The environment you will manage can be selected from the list of environments by clicking in a row with an environment of choice.

Environments list with webhooks management in CKEditor Ecosystem customer dashboard.

# Creating webhooks

The webhooks can be managed on a dedicated page. To switch to the Webhooks section, click the Webhooks tab.
The page shows existing webhooks and a button to add new ones.
The list is empty until you define some webhooks for a particular environment.

To create a new webhook, click the Create a new webhook button.

New webhook button in CKEditor Ecosystem customer dashboard.

The “Creating a webhook” page will show up.

Defining new webhooks in the CKEditor Ecosystem customer dashboard.

While creating a new webhook, you need to provide a Webhook URL that CKEditor Cloud Services will send the requests to. The provided endpoint must be available from the CKEditor Collaboration On-premises application.

In the next section you can configure the retry mechanism, if enabled, the webhooks will be resent in the case when the response code from the Webhook URL endpoint will be larger than 299.

The Webhook request will be retried for of number provided in the Max retries times, or until the response status 2xx will be returned.
Between each retry, there will be a delay, depending on the Retry Interval in minutes value.

Defining retries in new webhooks in CKEditor Ecosystem customer dashboard.

The next section allows you to select events of which occurrence will trigger the webhook.

A single webhook can be triggered by many events, depending on a need.

See the full list of available events in a dedicated article.

To finish the process you need to click the Save button at the very bottom of the form.
The newly created Webhook will appear on the list in the main view of the Webhooks tabs.

Webhooks list in the CKEditor Ecosystem customer dashboard.

# Updating webhook

Each webhook visible in this list can be edited. It can be done by clicking the Edit button.

Edit webhook button in CKEditor Ecosystem customer dashboard.

The button will open the “Editing the webhook” view. It presents exact same set of options as the “Create a new webhook” view.

You can change the Webhook URL, the set of events that will trigger the webhook, and the settings of the retry mechanism.

Edit webhook view in CKEditor Ecosystem customer dashboard.

If you decide to disable the previously enabled retries mechanism for a particular webhook, it will cancel all pending retries for that webhook.

To save the changes you need to click the Save button at the very bottom of the form.

You will be redirected to the list of created webhooks.

# Removing webhook

To remove a webhook use the remove button with an icon of a trash bin next to the selected webhook.

Button to remove webhook in CKEditor Ecosystem customer dashboard.

You will see the prompt to confirm the removal

Removing webhook confirmation modal in CKEditor Ecosystem customer dashboard.

# Next steps