Skip to main content

Webhooks — Getting Notified of Record Changes

D
Written by David Servodidio

What webhooks do

Instead of polling the API, you can subscribe to webhook events. VetVerifi will POST to your endpoint whenever a relevant record changes.

Available events

  • vaccine.updated — a vaccine record has been added or modified

  • vaccine.expiring — a vaccine will expire within 30 days (sent once)

  • vaccine.expired — a vaccine has passed its expiration date

  • pet.linked — a pet has been linked to your organization via VetVerifi

Registering a webhook

  1. Go to Developer > Webhooks in your VetVerifi account.

  2. Click Add Endpoint.

  3. Enter your HTTPS endpoint URL.

  4. Select the events you want to receive.

  5. Click Save. VetVerifi will send a test ping to verify your endpoint.

Verifying webhook signatures

Every webhook POST includes an X-VetVerifi-Signature header. Validate this against your webhook secret (found in your developer settings) using HMAC-SHA256 to ensure the request is genuine.

⚠️ Always validate webhook signatures in production. Unverified webhooks are a security risk.

Did this answer your question?