API referenceWebhooks

Delete a webhook endpoint

Try it live

playground

Path

idrequiredstring

The playground demo key has its own tenant. Run POST /v1/webhooks first; the id will auto-fill here.

30 requests per hour per IP · demo key used automatically

Auth

Requires the Authorization: Bearer <api_key> header. Use a vtv_live_* key in production or a vtv_test_* key for deterministic magic-number responses.

Path parameters

idrequiredstring

example 019d917e-4fa4-766e-9e0f-d977b47bf2c6

Error responses

401Missing or invalid API key

402Plan does not include webhooks — Pro or Business required

404Endpoint not found or belongs to a different key

import { Vatverify } from '@vatverify/node';
const client = new Vatverify();

const result = await client.deleteWebhook();

// 204 No Content, empty body by HTTP spec.

Registers an HTTPS URL to receive signed webhook events. The `secret` is returned once — store it securely. Requires Pro or Business plan.

List recent failures for one endpoint