overview

Webhooks allow you to receive real-time notifications about call events. When events occur, HMS Sovereign sends HTTP POST requests to your configured endpoint.

Available Webhooks

Webhook	Endpoint ID	Description
Assistant Request	`25570929`	Pre-call configuration
Tool Calls	`25570944`	Function execution
Status Update	`25570945`	Call lifecycle events
End of Call Report	`25570946`	Post-call summary

Configuration

Configure webhooks on your assistant:

Request Format

All webhooks send POST requests with:

Headers

Header	Description
`Content-Type`	`application/json`
`User-Assistant`	`HMS-Sovereign/1.0`
`X-Webhook-Event`	Event type
`X-Webhook-Timestamp`	Unix timestamp
`X-Webhook-Signature`	HMAC-SHA256 signature

Body Structure

{
  "message": {
    "type": "status-update",
    "timestamp": "2025-12-13T12:00:00.000Z",
    "call": {
      "id": "5c4d030f-43e3-4e65-899e-8148521e660f",
      "type": "inbound_phone_call",
      "status": "in-progress"
    },
    "phone_number": {
      "number": "+31850835037",
      "name": "HMS Sovereign Demo"
    },
    "customer": {
      "number": "+31612345678"
    }
  }
}

Response Requirements

Webhook	Response Required	Timeout
Assistant Request	Yes (config or empty)	5 seconds
Tool Calls	Yes (result)	10 seconds
Status Update	No (ignored)	-
End of Call Report	No (ignored)	-

Next Steps

Assistant Request Webhook - Dynamic assistant configuration

Tool Calls Webhook - Function execution

Security - Verify webhook signatures

Available Webhooks#

Configuration#

Request Format#

Headers#

Body Structure#

Response Requirements#