Skip to main content
GET
/
sip
/
hooks
Lists all configured SIP hooks.
curl --request GET \
  --url https://api.sayna.ai/sip/hooks \
  --header 'Authorization: Bearer <token>'
{
  "hooks": [
    {
      "auth_id": "tenant-123",
      "host": "example.com",
      "url": "https://webhook.example.com/events"
    }
  ]
}
Lists all configured SIP hooks from the runtime state. Useful for debugging host-to-URL routing when forwarding LiveKit SIP webhooks.

​
Response

Returns { hooks: [...] } with each hook containing:
  • host - Host pattern for matching SIP domains (case-insensitive)
  • url - HTTPS URL to forward webhook events to
  • auth_id - Tenant identifier for room ownership (used for metadata.auth_id)
The auth_id field associates inbound SIP calls with a specific tenant. When a call arrives, Sayna sets the room’s metadata.auth_id to this value for access control.

​
Authorization

Requires authentication when AUTH_REQUIRED=true.

Authorizations

​
Authorization
string
header
required

Authentication token for protected endpoints. Can be provided as Authorization: Bearer <token> or ?api_key=<token>. Required when AUTH_REQUIRED is enabled.

Response

List of SIP hooks

Response body for SIP hooks operations.

​
hooks
object[]
required

List of all configured SIP hooks