Developer reference
Webhooks and Notifications
Outbound webhooks are not generally available. Confirm availability, supported events, and delivery testing with SecurePoint before building an integration.
Event Coverage
Outbound webhooks are a configured feature. The event types below have producers in selected Visitor and v1 workflows; they do not promise coverage of every action in the application. SecurePoint must confirm the events and delivery available for your integration.
- visitor.checkin
- visitor.checkout
- visitor.approved
- visitor.denied
- screening.decision
- screening.completed
- screening.escalated
- adjudication.disposition_changed
- evidence.ready
- session.under_review
Delivery Lifecycle
When delivery is enabled, deliveries can be pending, delivering, delivered, failed, or dead. A dead delivery has stopped retrying. Retries are controlled by max_retries on each endpoint. If outbound webhooks are not enabled, endpoint management is unavailable and events are not delivered.
Signed Payloads
Validate X-Spusa-Signature and X-Spusa-Timestamp before processing webhook payloads.
Structured Event Body
Each delivery includes event type, organization id, and a data object with event payload details.
Endpoint Operations
Work with SecurePoint to confirm endpoint registration, secret rotation, and delivery monitoring for an approved integration.
Before Implementing a Receiver
- Obtain the agreed event catalog, payload samples, and signing format from SecurePoint.
- Keep the signing secret server-side. Verify the signature against the raw request body and reject stale timestamps before processing.
- Use the delivery identifier to detect duplicates, and agree on acknowledgement, retries, and terminal-failure handling.
- Complete a delivery test in the approved environment before relying on an integration.
Until availability is confirmed, use the approved API to retrieve screening results and adjudication status.
Need help wiring an integration?
We can provide event catalogs, payload samples, and testing guidance for your systems.
Talk to the team