Skip to main content

Webhooks

Webhooks let ScanAspect notify your systems the instant something happens — a scan, a document open, or a chat message — so you can react in real time.

Setting up an endpoint

Add a webhook URL in your dashboard and choose the events you care about. ScanAspect sends a JSON POST to your endpoint each time a subscribed event fires.

Available events

  • scan.created — a code was scanned.
  • document.opened — a recipient opened a trackable PDF.
  • chat.message_sent — a scanner sent a message to an AI chat agent.

Verifying signatures

Every delivery includes a signature header computed from your webhook secret. Verify it before trusting the payload so you know the request genuinely came from ScanAspect.

Popular integrations

Point your webhook at Slack to get scan and chat alerts in a channel, or at n8n to trigger downstream automations without code. Webhooks also pair well with the ScanAspect API when you need to enrich the payload before forwarding it on.

Prefer to pull data on your own schedule? See the API reference.