Configure webhooks
There are a variety of services you can connect to Cloudflare using webhooks to receive Notifications from your Cloudflare account. The following table lists some of the most popular services you can connect to your Cloudflare account, as well as the information you need to connect to them:
| Service | Secret | URL |
|---|---|---|
| Google Chat | The secret is part of the URL. Cloudflare parses this information automatically and there is no input needed from the user. | URL varies depending on the Google Chat channel’s address. |
| Slack | The secret is part of the URL. Cloudflare parses this information automatically and there is no input needed from the user. | URL varies depending on the Slack channel’s address. |
| DataDog | The secret is required and has to be entered by the user. This is what DataDog refers to as API Key. | https://api.datadoghq.com/api/v1/events |
| Discord | The secret is part of the URL. Cloudflare parses this information automatically and there is no input needed from the user. | URL varies depending on the Discord channel’s address. |
| OpsGenie | The secret is the API Key for OpsGenie’s REST API. | https://api.opsgenie.com/v2/alerts |
| Splunk | The secret is required and has to be entered by the user. This is what Splunk refers to as token. Refer to Splunk’s documentation for details. | 1. We only support three Splunk endpoints: services/collector, services/collector/raw, and services/collector/event.2. If SSL is enabled on the token, the port must be 443. If SSL is not enabled on the token, the port must be 8088. 3. SSL must be enabled on the server. |
| Generic webhook | User decides. | User decides. |
After configuring the external service you want to connect to, set up webhooks in your Cloudflare dashboard:
- Go to Notifications on the Cloudflare dashboard.
- Click Destinations.
- In the Webhooks card, click Create.
- Give your webhook a name, so you can identify it later.
- In the URL field, enter the URL of the third-party service you previously set up and want to connect to your Cloudflare account.
- If needed, insert the Secret. Secrets are how webhooks are encrypted and vary according to the service you are connecting to Cloudflare.
- Click Save and Test to finish setting up your webhook.
The new webhook will appear in the Webhooks card.
Generic webhooks
If you use a service that is not covered by Cloudflare’s currently available webhooks, you can configure your own. Follow steps 1-6 above, and enter a valid webhook URL. It is always recommended to use a secret for generic webhooks. Cloudflare will send your secret in the cf-webhook-auth header of every request made. If this header is not present, or is not your specified value, you should reject the webhook.
After clicking Save and Test, your webhook should now be configured as a destination you can use to attach to policies.
When Cloudflare sends you a webhook, it will have the following schema:
{ "text": Hello World! This is a test message sent from https://cloudflare.com. If you can see this, your webhook is configured properly.}In the above example, "text" will vary depending on the alert that was fired.
Use generic webhooks with Workers
You can use Cloudflare Workers with a generic webhook to deliver notifications to any service that accepts webhooks.
Cloudflare has an example tool to help you understand how you can use Workers and generic webhooks. The example provided transforms a generic webhook response in order for it to be delivered to Rocket.Chat. The code provided is heavily commented to guide you in the process of adapting the example to your needs.