Skip to main content
Use webhooks when your product should react as soon as enrichment finishes — for example, updating a lead record in your database or kicking off an email sequence.

Setup checklist

  1. Deploy an HTTPS endpoint (see Webhooks guide).
  2. In Seamless: Settings → Webhooks → create webhook → select Contact Research or Company Research.
  3. Submit research via Research contacts or Research companies.
  4. Match incoming payloads to your stored requestId if you track jobs in a queue.

Events and payloads

A Contact Research webhook receives each enriched contact and a Company Research webhook each enriched company; the body is the record itself. Validate the x-seamless-webhook-secret header on every request. For the payload shapes, see Payloads.

Runnable local test

  1. Start the receiver from Webhooks.
  2. Use ngrok or similar to expose https://your-tunnel/webhooks/research-results.
  3. Register that URL in Settings → Webhooks.
  4. Submit one research request and confirm your server logs the payload.

Fallback

If a webhook delivery fails, poll with the saved requestId — see Poll contact research.