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.

OAuth Discovery

IP Addresses

IP Ranges

SIM Cards

Addresses

Advanced Number Orders

Assistants

Audio

Chat

Clusters

Conversations

Embeddings

Fine Tuning

Integrations

MCP Servers

Audit Logs

Authentication Providers

Phone Number Search

Billing

Billing Groups

Brands

SIM Card Actions

Bundles

User Bundles

Call Control Applications

Debugging

Call Commands

Call Information

Campaign

Voice Channels

API Reference

Phone Number Orders

Conference Commands

Connections

Country Coverage

Credential Connections

Call Recordings

Customer Service Record

Detail Records

Dialogflow Integration

Documents

Dynamic Emergency Addresses

Dynamic Emergency Endpoints

Enum

External Connections

Programmable Fax Applications

Programmable Fax Commands

FQDN Connections

FQDNs

Global IPs

Inexplicit Number Orders

Integration Secrets

Inventory Level

IP Connections

IPs

Reports

MDR Detailed Reports

Speech to Text Batch Reports

CDR Reports

MDR Usage Reports

Telco Data Usage Reports

Speech to text Usage Reports

CDR Usage Reports

Managed Accounts

Media Storage API

Messages

RCS messaging

Messaging Hosted Number

Number Configurations

Advanced OptIn/OptOut

Messaging Profiles

Messaging Tollfree Verification

Messaging URL Domains

Mobile Network Operators

Push Credentials

Coverage

Networks

Notifications

Phone Number Block Orders

Number Lookup