Webhooks

Send a test event to a webhook

Performs a synchronous delivery of a webhook.test event and returns the result (status code, response time, error if any).

Test deliveries are not counted as real events: they do NOT update last_triggered_at, last_status or failure_count on the webhook. Use this endpoint to verify connectivity from the dashboard or CI without polluting the production delivery history.

post/api/v1/webhooks/{id}/test

Request

  • Base URL: https://api.dmarc-examiner.com
  • URL: https://api.dmarc-examiner.com/api/v1/webhooks/{id}/test
  • Auth: API key in header X-API-Key

Path parameters

idstring uuid required

Response

Delivery result

successboolean required

True only when the sink answered with a 2xx status. Network errors and non-2xx responses both return false.

status_codeinteger nullable required

HTTP status returned by the sink. 0 when the request never reached it (timeout, DNS failure, connection refused, etc.).

response_time_msinteger required

Milliseconds elapsed between request start and the response (or the failure point).

errorstring nullable required

Error message when the request could not be completed. Null on a normal HTTP exchange (even if the status was non-2xx).

Example response

{
  "status_code": 200,
  "response_time_ms": 138
}

Changes

No recorded changes to this operation across all 1 revision of this API.