PUT /accounts/{account_id}/data-security/posture/webhooks/{webhook_id}
Updates an existing webhook configuration with new settings.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Cloudflare account ID for the user making the request. |
webhook_id |
String | Yes |
A UUID identifying the webhook configuration. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
destination_url |
String | Yes |
Target URL for the webhook configuration. Where resulting data will be sent. |
label |
String | Yes |
Account-specified display label for the webhook configuration. |
signing_secret |
String | No |
Secret key used for HMAC signing when authentication_type is "HMAC-Signing". |
authentication_type |
String | Yes |
Type of authentication used for the webhook. Valid values:
|
status |
String | Yes |
Status of the webhook configuration. Valid values:
|
headers[] |
Array | No |
List of custom headers to include in webhook requests. |
headers[].key |
String | Yes |
Header key name. |
headers[].value |
String | No |
Header value. Required on Create and Evaluate. On Update, omit or set to null to keep existing value. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.