Send a test event
Queue a sample audit.completed event (built with this endpoint's payload settings, is_test: true) and return its webhook_delivery with 202. It goes through the normal signed delivery path within seconds; poll GET /v2/webhook_deliveries/{id} for the outcome. Works while the endpoint is disabled, so you can test a fix before re-enabling. Test events get one attempt. Limited to 10 per minute per org, counting test events sent from the dashboard and resends of test deliveries: the RateLimit-* headers on this route describe that limit, and a 429 carries Retry-After. The body is optional.
OAuth scopes
- webhooks:write
Path Parameters
- Type: stringFormat: uuididrequired
Body·
application/json
- enumevent
_type const:audit.completedEvent type.
audit.completedfires each time an audit completes, including a re-completion after an update.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for post/v2/webhook_endpoints/{id}/test
curl https://api.brellium.dev/v2/webhook_endpoints/123e4567-e89b-12d3-a456-426614174000/test \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"event_type": "audit.completed"
}'
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"object": "webhook_delivery",
"org_id": "string",
"endpoint_id": "123e4567-e89b-12d3-a456-426614174000",
"event_id": "123e4567-e89b-12d3-a456-426614174000",
"event_type": "audit.completed",
"audit_id": null,
"is_test": true,
"status": "retrying",
"attempt_count": 1,
"next_attempt_at": "2026-09-24T02:35:24.489Z",
"last_response_status": null,
"last_error": {
"code": "connection_error",
"message": "Connection refused"
},
"delivered_at": null,
"created_at": "2026-09-24T02:34:54.489Z",
"updated_at": "2026-09-24T02:34:54.489Z"
}