Telnyx

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

telnyx-timestamp

integer<int64>

required

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

telnyx-signature-ed25519

string

required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification

Body

application/json

data

object

required

Show child attributes

data.event_type

string

required

The type of event being sent

Example:

"number_order.complete"

data.id

string<uuid>

required

Unique identifier for the event

Example:

"d578b093-a0e7-4b64-b0d3-6b689a6ff170"

data.occurred_at

string<date-time>

required

ISO 8601 timestamp of when the event occurred

Example:

"2025-08-22T16:23:54.496464Z"

data.payload

NumberOrder · object

required

Show child attributes

data.payload.connection_id

string

Identifies the connection associated with this phone number.

Example:

"346789098765567"

data.payload.messaging_profile_id

string

Identifies the messaging profile associated with the phone number.

Example:

"abc85f64-5717-4562-b3fc-2c9600"

data.payload.billing_group_id

string

Identifies the messaging profile associated with the phone number.

Example:

"abc85f64-5717-4562-b3fc-2c9600"

data.payload.phone_numbers

object[]

Show child attributes

data.payload.phone_numbers.phone_number

string

Example:

"+19705555098"

data.payload.phone_numbers.regulatory_requirements

object[]

Show child attributes

data.payload.phone_numbers.regulatory_requirements.requirement_id

string<uuid>

Unique id for a requirement.

Example:

"8ffb3622-7c6b-4ccc-b65f-7a3dc0099576"

data.payload.phone_numbers.regulatory_requirements.field_value

string

The value of the requirement, this could be an id to a resource or a string value.

Example:

"45f45a04-b4be-4592-95b1-9306b9db2b21"

data.payload.sub_number_orders_ids

string[]

data.payload.customer_reference

string

A customer reference string for customer look ups.

Example:

"MY REF 001"

data.record_type

string

required

Type of record

Example:

"event"

Response

200

The server must return a HTTP 200, otherwise we will reattempt to deliver the webhook to the failover URL.

Coverage

Regulatory

Searching

Ordering

Port In

Port Out

Management & Configurations

All Others

Number order status update

Authorizations

Headers

Body

Response