Callbacks
Number Order Status Update
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.
postWebhooknumberOrderStatusUpdate
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": "number_order.complete",
"id": "d578b093-a0e7-4b64-b0d3-6b689a6ff170",
"occurred_at": "2025-08-22T16:23:54.496464Z",
"payload": {
"billing_group_id": "abc85f64-5717-4562-b3fc-2c9600",
"connection_id": "346789098765567",
"created_at": "2018-01-01T00:00:00.000000Z",
"customer_reference": "MY REF 001",
"id": "12ade33a-21c0-473b-b055-b3c836e1c292",
"messaging_profile_id": "abc85f64-5717-4562-b3fc-2c9600",
"phone_numbers": [
{
"bundle_id": "bc8e4d67-33a0-4cbb-af74-7b58f05bd474",
"id": "dc8e4d67-33a0-4cbb-af74-7b58f05bd494",
"phone_number": "+19705555098",
"record_type": "number_order_phone_number",
"regulatory_requirements": [
{
"field_type": "address",
"field_value": "45f45a04-b4be-4592-95b1-9306b9db2b21",
"record_type": "phone_number_regulatory_requirement",
"requirement_id": "8ffb3622-7c6b-4ccc-b65f-7a3dc0099576"
}
],
"requirements_met": true,
"status": "success"
}
],
"phone_numbers_count": 1,
"record_type": "number_order",
"requirements_met": true,
"updated_at": "2018-01-01T00:00:00.000000Z"
},
"record_type": "event"
},
"meta": {
"attempt": 1,
"delivered_to": "https://sample-api.com/webhook"
}
}Response
The server must return a HTTP 200, otherwise we will reattempt to deliver the webhook to the failover URL.