Webhooks

Webhooks help you keep downstream systems in sync with export completion, subscription changes, and low-credit alerts.

Supported Events

export.completed
export.failed
credits.low
subscription.updated
company.revealed

Signature Verification

Webhook deliveries include an X-PrimoDato-Signature header. Verify the payload with your webhook secret before processing the event body.

{
  "id": "evt_01",
  "type": "export.completed",
  "created_at": "2025-01-14T12:45:02Z",
  "data": {
    "export_id": "exp_01",
    "download_url": "https://storage.primodato.com/exports/exp_01.csv"
  }
}