Monitor API
Test a monitor's webhook
Send a signed test event to a monitor’s configured webhook and inspect the delivery outcome.
POST
This endpoint sends one
monitor.webhook.test event to the current webhook URL, signed with the current secrets. It takes no request body and returns after the receiver responds or the 10-second attempt times out.
HTTP 200 means the test completed, not necessarily that delivery succeeded. Check delivered, status_code when available, and error for the outcome.
When delivery fails, error is a typed string such as http_status, timeout, network_error, or tls_certificate. An http_status error includes the receiver’s status_code; redirects count as failures. Allow for new error values. A delivered test omits error.
The attempt is not retried and does not count toward the webhook_failing pause threshold. A monitor without a webhook returns HTTP 409 with invalid_state; add a webhook before testing.
Authorizations
Response
The outcome of the send, delivered or not
The outcome of one test send