Setup checklist
- Deploy an HTTPS endpoint (see Webhooks guide).
- In Seamless: Settings → Webhooks → create webhook → select Contact Research or Company Research.
- Submit research via Research contacts or Research companies.
- Match incoming payloads to your stored
requestIdif 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 thex-seamless-webhook-secret header on every request. For the payload shapes, see Payloads.
Runnable local test
- Start the receiver from Webhooks.
- Use ngrok or similar to expose
https://your-tunnel/webhooks/research-results. - Register that URL in Settings → Webhooks.
- Submit one research request and confirm your server logs the payload.
Fallback
If a webhook delivery fails, poll with the savedrequestId — see Poll contact research.