More / Webhooks

Webhooks.

Coming soon. Every Leadsets call answers in its own response today, so there is nothing to notify you about yet. Webhooks will arrive with async jobs.

Status

Not available yet. Nothing on this page works today. There are no webhook settings, no events and no async jobs: GET /v1/jobs/{id} answers 404 for every id. We'll announce webhooks in the changelog.

What to do today

Call the API and read the result from the response. Search, enrich and verify answer in seconds; scrape calls can take longer for many pages.
Page through large searches with cursors, and verify up to 100 emails per call with POST /v1/emails/verify.
Split large runs across windows. Read usage on each response or call GET /v1/usage to pace them.
Retry safely with an Idempotency-Key.

What is planned

Async jobs for large batches: you start a job and get its id back at once, then read its status at GET /v1/jobs/{id}. A webhook will call a URL you choose when a job finishes, so you don't have to poll.

A draft of the event, to show the idea. It will change before launch, so don't build against it:

{
  "type": "job.completed",
  "job_id": "job_7Qd2…",
  "status": "succeeded",
  "created_at": "2026-12-01T10:00:00Z",
  "finished_at": "2026-12-01T10:04:12Z"
}

Want it sooner, or have a use case we should design for? Email support@leadsets.ai.

Previous
← IdempotencyNext
Changelog →

Was this page useful? Tell us