Event Types
Public webhook event types and when they fire.
PacSpace sends webhooks when a record changes in a way your app may need to react to.
Event Reference
Deltas
| Event | Fires when |
|---|---|
delta.verified | A usage delta is recorded and verified. |
delta.failed | A usage delta reaches a failed state. |
Use delta.verified to update your app after usage is recorded. Use delta.failed to alert an operator or retry with corrected input.
Checkpoints
| Event | Fires when |
|---|---|
checkpoint.verified | A period or window checkpoint is verified. |
Use this event before invoice runs, close workflows, or monthly exports.
Receipts
| Event | Fires when |
|---|---|
receipt.generated | A shareable receipt is generated. |
Customer Records
| Event | Fires when |
|---|---|
customer.created | A customer record is created in the dashboard. |
customer.shared_record_viewed | A customer views a Shared Record link. |
customer.export_downloaded | A customer export is downloaded. |
customer.compare_run | A comparison is run for a customer record. |
customer.step_up_failed_repeatedly | A Shared Record has repeated failed step-up attempts. |
Tenant Domains
| Event | Fires when |
|---|---|
tenant_domain.activated | A tenant domain becomes active. |
tenant_domain.cert_renewal_failed | A tenant domain certificate renewal needs attention. |
Subscribing to Events
When creating a webhook, PacSpace subscribes it to the public event catalog for your tenant:
bash
curl -X POST https://app.pacspace.io/dashboard/webhooks \
-b pacspace-dashboard-cookies.txt \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-app.com/webhooks"
}'
Event filtering is not yet supported in the create webhook API. Configure separate handling inside your webhook endpoint.
Event Envelope
Every webhook delivery uses the same envelope structure:
json
{
"event": "delta.verified",
"timestamp": "2026-02-11T10:30:00Z",
"data": {
// ... event-specific payload
}
}
| Field | Type | Description |
|---|---|---|
event | string | The event type identifier |
timestamp | string | ISO 8601 timestamp of when the event occurred |
data | object | Event-specific payload (see Payload Reference) |
Next Steps
- Payload Reference - Example payloads
- Signature Verification - Authenticate incoming webhooks