Webhooks

Get notified when entity data changes instead of polling. Requires an API key. Events:

• entity.updated - profile edited or re-registered
• entity.verified - an admin verified or revoked a GST/MCA claim
• citation.appeared - a real AI platform newly cited this business
• citation.lost - a real, tracked score drop was detected on a platform
• competitor.overtook - a real competitor crossover was detected

curl -X POST https://visibilityai.in/api/developers/webhooks \
  -H "Authorization: Bearer vai_live_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://you.example.com/hook", "events": ["entity.updated"]}'

The response includes a secret shown once - verify every delivery using the X-VisibilityAI-Signature header (HMAC-SHA256 of the raw request body with your secret) before trusting the payload.

Failed deliveries are retried automatically (up to 5 attempts, exponential backoff) - nothing is dropped silently.