Webhook management

Send a test event

Sends a signed webhook.test event to the endpoint and returns the live result (status code, latency, error) without persisting it to delivery history. A successful (2xx) test is the only way a webhook becomes active.

post/v1/webhooks/{id}/test

Request

  • Base URL: https://api.vatnode.dev
  • URL: https://api.vatnode.dev/v1/webhooks/{id}/test
  • Auth: one of:
    • API key in cookie better-auth.session_token
    • HTTP bearer

Path parameters

idstring required

Webhook identifier.

Response

The live test result. ok is true only for a 2xx response from the endpoint; transport failures return ok: false with a null status code and an error message.

okboolean required

True only for a 2xx response from the endpoint.

statusCodeinteger nullable required
statusTextstring nullable
durationMsinteger required
errorstring nullable required
requestobject

The request that was sent (method, URL, headers, body).

responseobject nullable

The endpoint’s response (headers, body), or null on transport failure.

Changes

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