API referenceWebhooks
Rotate the webhook secret; returned once
Try it live
playgroundPath
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
idrequiredstringexample
019d917e-4fa4-766e-9e0f-d977b47bf2c6200
Response
Rotated
datarequiredobjectdata.
idrequiredstringdata.
secretrequiredstringThe new secret. Shown only once.
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.rotateWebhookSecret();{
"data": {
"id": "9b8e1a2c-4d6f-4e0b-9b2a-1c3d5e7f9a2b",
"secret": "…"
}
}