Skip to main content
WEBHOOK
fax.delivered
{
  "data": {
    "event_type": "fax.delivered",
    "id": "95479a2e-b947-470a-a88f-2da6dd07ae0f",
    "occurred_at": "2020-05-05T13:08:22.039204Z",
    "payload": {
      "call_duration_secs": 25,
      "connection_id": "234423",
      "direction": "outbound",
      "fax_id": "f8338808-3dc6-4f2b-942a-5d1f39255784",
      "from": "+17733372107",
      "original_media_url": "http://www.example.com/fax.pdf",
      "page_count": 2,
      "status": "delivered",
      "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
      "to": "+15107882622",
      "user_id": "19a75cea-02c6-4b9a-84fa-c9bc8341feb8"
    },
    "record_type": "event"
  }
}

Headers

​
telnyx-timestamp
integer
required

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

​
telnyx-signature-ed25519
string
required

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

Body

application/json
​
record_type
enum<string>

Identifies the type of the resource.

Available options:
event
Example:

"event"

​
id
string<uuid>

Identifies the type of resource.

Example:

"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0"

​
event_type
enum<string>

The type of event being delivered.

Available options:
fax.delivered
Example:

"fax.delivered"

​
payload
object

Response

200

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