Webhooks

Overview

Webhooks allow you to receive HTTP callbacks when certain events occur in your account. Instead of polling the API, you can subscribe to events and receive real-time notifications.

Setting Up Webhooks

Configure your webhook endpoint in the dashboard settings. Your endpoint must:

Webhook Events

Webhook Payload

All webhook payloads follow this structure:

{
  "id": "evt_abc123xyz",
  "type": "enrich.completed",
  "created": "2026-01-15T12:00:00Z",
  "data": {
    "requestId": "req_xyz789",
    "url": "stripe.com",
    "result": {
      "domain": "stripe.com",
      "name": "Stripe",
      "industry": "Financial Technology",
      // ... full enrichment data
    }
  }
}

Verifying Webhooks

All webhooks include a signature in the X-Vera-Signature header. Always verify this signature to ensure the webhook is authentic.

X-Vera-Signature: sha256=abc123...
X-Vera-Timestamp: 1705320000
Content-Type: application/json

import crypto from 'crypto';

function verifyWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(`sha256=${expectedSignature}`)
  );
}

Retry Policy

If your endpoint returns a non-2xx status code or times out, we'll retry the webhook with exponential backoff:

Best Practices