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.

Architecture

Setup checklist

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

Event types

Validate the x-seamless-webhook-secret header on every request.

Example company payload

When research completes, Seamless POSTs a JSON body with the enriched company object. Shape matches the public API Company schema (see API Reference — Company Research).
Contact webhooks return a Contact object with fields such as fullname, email, phone, title, and company — see API Reference — Contact Research.

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.