POST /accounts/{account_id}/data-security/posture/webhooks/evaluate
Sends a test webhook event to the specified destination URL to verify the webhook endpoint is reachable and properly configured. This allows customers to validate their webhook configuration before creating the actual webhook resource.
The test payload includes:
- event_type: "webhook.test"
- timestamp: Current UTC timestamp
- message: Test message indicating this is from Cloudflare CASB
- data: Object with test: true
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. |
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 to send the test webhook event to. |
signing_secret |
String | No |
Secret key used for HMAC signing when authentication_type is "HMAC-Signing". |
authentication_type |
String | Yes |
Type of authentication to use for the test webhook request. Valid values:
|
headers[] |
Array | No |
List of custom headers to include in the test webhook request. |
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.