Skip to main content

​
Webhooks

When visitors are identified, we send events to your webhook endpoints in real-time.

Webhook API Reference

Full webhook schemas with TypeScript, Python, and Go SDK examples

​
Setup

  1. In the Console, click Webhooks → Create Webhook
  2. Select the pixel to bind the webhook to
  3. Enter your endpoint URL
  4. Choose which events to receive
Each webhook endpoint gets its own signing secret for signature verification.

​
Events

EventDescriptionUse Case
identity.resolvedVisitor first recognizedReal-time personalization
identity.qualifiedIdentity verified with professional dataLead qualification
identity.enrichedFull enrichment completeCRM sync, lead scoring
identity.validatedEmail validation completeEmail deliverability
identity.session.finalizedSession concludedBehavioral analytics
Start with identity.enriched for most use cases. Use identity.session.finalized if you need behavioral data (pages visited, engagement time).

​
Retries

Failed webhook deliveries (non-2xx response) are retried with exponential backoff:
  • Retry 1: 5 seconds
  • Retry 2: 30 seconds
  • Retry 3: 2 minutes
  • Retry 4: 10 minutes
  • Retry 5: 30 minutes
After 5 failed attempts, the event is dropped.