Setting up your first webhook

Webhooks push new records to your server the moment we observe them, so you do not have to poll. This is the recommended way to react to filings quickly.

Step 1 — Build an endpoint

Create a publicly reachable HTTPS URL that accepts POST requests and returns a 2xx status quickly. Do the heavy work asynchronously — acknowledge first, process after.

Step 2 — Register it

In Settings → Webhooks, add the URL and choose the same filters you would use on the list endpoint. You will only receive records that match, which keeps noise out of your pipeline.

Step 3 — Handle the payload

Each delivery contains an event wrapper and the license record. Always verify the signature before trusting the contents (see "Verifying webhook signatures").

{
  "id": "evt_19a2",
  "type": "license.created",
  "created": "2026-06-14T15:04:00Z",
  "data": { "id": "lic_77c1", "businessName": "..." }
}

• Return a 2xx within a few seconds to mark the delivery successful.
• Deduplicate on the event id — deliveries can arrive more than once.
• Move slow work to a background queue so you never time out.