Webhooks

VIES_UNAVAILABLE

Sent at 23:00 UTC when every retry attempt (hourly between 06:00 and 22:00 UTC) failed to reach VIES for this subscription. The previous recorded state of the VAT ID is unchanged – this event signals only that the daily check could not complete.

postWebhookviesUnavailable

Headers

X-Vatnode-Signaturestring required

Example:t=1747636992,v1=8f43...c0

HMAC-SHA256 over <t>.<raw request body>, keyed with the full per-webhook signing key (vat_wh_…, prefix included), formatted as t=<unix-seconds>,v1=<hex-hmac>. Verify it before trusting the payload.

X-Vatnode-Eventstring required

Example:VAT_BECAME_INVALID

The event type, mirroring the event field in the body.

Payload

idstring required

Stable, unique identifier for the event. Identical across every retry of the same delivery – use it to deduplicate.

versionstring required

Envelope schema version. Currently 1. Bumped only on a breaking change to the payload shape, so consumers can version-handle safely.

event'VIES_UNAVAILABLE' required

Event type. See per-envelope schema for allowed values.

timestampstring date-time required

When the event was emitted (ISO-8601, UTC).

Example payload

{
  "version": "1",
  "data": {
    "reason": "VIES unreachable for full day"
  }
}

Response

Acknowledged.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.