v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Callbacks

Call Siprec Failed

This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

postWebhookcallSiprecFailed

Headers

telnyx-timestampinteger required

Unix timestamp for replay attack prevention

Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp

telnyx-signature-ed25519string required

Ed25519 signature of timestamp|payload for verification

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature

Payload

Example payload

{
  "data": {
    "event_type": "siprec.failed",
    "id": "25dc3731-e51e-4927-a50d-a61cc25984b1",
    "occurred_at": "2021-12-15T14:11:24.613295Z",
    "payload": {
      "call_control_id": "31f19208-5db0-11ec-9ea7-02420a0d3a69",
      "call_leg_id": "31f19208-5db0-11ec-9ea7-02420a0d3a69",
      "call_session_id": "31f19208-5db0-11ec-9ea7-02420a0d3a69",
      "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
      "connection_id": "7267xxxxxxxxxxxxxx",
      "failure_cause": "no_answer"
    },
    "record_type": "event"
  }
}

Response

The server must return an HTTP 200, otherwise we will reattempt delivery at the failover webhook URL.