This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuAPI Reference
API Reference
Close Sidemenu

Inbound Channels

Retrieve your inbound channelslistOutboundChannels

get https://api.telnyx.com/v2/phone_numbers/inbound_channels

Returns the inbound channels for your account. Inbound channels allows you to use Channel Billing for calls to your Telnyx phone numbers. Please check the Telnyx Support Articles section for full information and examples of how to utilize Channel Billing.

curl -X GET \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --globoff "https://api.telnyx.com/v2/phone_numbers/inbound_channels"
Responses
200

Inbound Channels Response

401

Unauthorized

404

Resource not found

422

Unprocessable entity. Check message field in response for details.

Success Response
{
  "data": {
    "channels": 7,
    "record_type": "inbound_channels"
  }
}

Update inbound channelsupdateOutboundChannels

patch https://api.telnyx.com/v2/phone_numbers/inbound_channels

Update the inbound channels for the account

curl -X PATCH \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --data '{"channels": 10}' \
  https://api.telnyx.com/v2/phone_numbers/inbound_channels
Parameters
In body
channels
integer
required

The new number of concurrent channels for the account

Example: 7
Responses
200

Expected Update response

default

Unexpected error

Success Response
{
  "data": {
    "channels": 7,
    "record_type": "inbound_channels"
  }
}

Was this section helpful?was-this-page-helpful