Webhook management

Create a webhook

Registers a new webhook endpoint. The URL must be a publicly reachable HTTPS endpoint (validated against SSRF). The signing secret is returned exactly once in this response. New webhooks start disabled and are activated only after a successful test delivery (POST /v1/webhooks/{id}/test).

post/v1/webhooks

Request

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

Request body

urlstring uri required

Publicly reachable HTTPS endpoint.

Example request

{
  "url": "https://example.com/webhooks/vatnode"
}

Response

The created webhook, including the signing secret (shown once).

idstring required
urlstring uri required
status'disabled' required

New webhooks start disabled until a test delivery succeeds.

secretstring required

HMAC signing key. Returned only once, at creation.

createdAtstring date-time required
updatedAtstring date-time required

Changes

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