Webhooks

Receive real-time notifications when events happen in your Secrealm AI account.

Event Types

call.completedFired when a voice call ends, includes duration and recording URL.
ticket.resolvedFired when a helpdesk ticket is marked as resolved.
document.processedFired when OCR or document generation finishes.
workflow.completedFired when an automation workflow run completes.
invoice.generatedFired when a new invoice is created in the billing module.
user.createdFired when a new user is added to your organization.

Delivery Details

  • Delivered via HTTPS POST to your configured endpoint
  • JSON payload with consistent schema across all event types
  • Retry policy: 3 attempts with exponential backoff

Security

Every webhook request includes an X-Secrealm-Signature header containing an HMAC-SHA256 signature. Verify this signature using your webhook secret to ensure the request originated from Secrealm AI.

Example Payload

{
  "id": "evt_abc123",
  "type": "call.completed",
  "created_at": "2026-03-28T14:22:00Z",
  "data": {
    "call_id": "call_xyz789",
    "duration": 124,
    "direction": "inbound",
    "status": "completed",
    "recording_url": "https://api.secrealmai.com/v1/recordings/call_xyz789"
  }
}

Start receiving events

Configure Webhooks