# Webhook management

Webhooks allow you to receive notifications when new data is available. You can configure webhooks via the API itself or via the console.<br>
To create a webhook, go to the [API console](https://mycirrus.cloud/developer-webhooks) and click the "Create Webhook" button.

These are the endpoints you can use to manage your webhooks:

## Create a new webhook

 - [POST /webhooks](https://mycirrus.redocly.app/apis/mycirrus-main/webhook-management/addwebhook.md): Add a new webhook.

The secret can be set or left blank. If left blank, a random secret will be generated and returned in the response.
This is then used to sign the webhook payloads to verify that they are from MyCirrus.

Requires an API key with the webhooks:write scope.

## Get a list of webhooks

 - [GET /webhooks](https://mycirrus.redocly.app/apis/mycirrus-main/webhook-management/getwebhooks.md): Get a list of all the current webhooks.

Requires an API key with the webhooks:read scope.

## Remove a webhook

 - [DELETE /webhooks/{webhookId}](https://mycirrus.redocly.app/apis/mycirrus-main/webhook-management/deletewebhook.md): Remove the webhook with the given id.

Requires an API key with the webhooks:write scope.

## Get a webhook

 - [GET /webhooks/{webhookId}](https://mycirrus.redocly.app/apis/mycirrus-main/webhook-management/getwebhook.md): Get the webhook with the given id.

Requires an API key with the webhooks:read scope.