telnyx

name

telnyx

description

Telnyx is a communications platform that provides APIs for voice, messaging, phone numbers, wireless connectivity, and networking services, allowing developers and businesses to build telephony, SMS, IoT, and real-time communication workflows on programmable infrastructure. Read and write Telnyx data through One: calls, conferences, phonenumbers, externalconnections, portingorders, simcards and more, 1163 actions with real parameter documentation. Use whenever the user asks to look something up in Telnyx, create or update a record there, or build code against the Telnyx API.

Telnyx through One

Telnyx is a communications platform that provides APIs for voice, messaging, phone numbers, wireless connectivity, and networking services, allowing developers and businesses to build telephony, SMS, IoT, and real-time communication workflows on programmable infrastructure.

One exposes Telnyx through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform telnyx if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Telnyx is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Telnyx account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Calls

Action	Method	Path	Action id
List Calls for an Account	GET	/v2/texml/Accounts/{{accountSid}}/Calls	conn_mod_def::GMTguAl684A::DbwIgcTjS4aAJj_b1jgCKA
Retrieve Call Status	GET	/v2/calls/{{callControlId}}	conn_mod_def::GMTgTaSvw8g::YsKnY1AASQi-QgVZbj08Eg
Add Messages to an AI Assistant for a Call	POST	/v2/calls/{{callControlId}}/actions/ai_assistant_add_messages	conn_mod_def::GMTgR0K95MA::AzdsMkUOT5OPz0nG6J8u3w
AI Assistant Join Using Calls Actions	POST	/v2/calls/{{callControlId}}/actions/ai_assistant_join	conn_mod_def::GMTgSOmgMcA::FThbyMonT1yxGrUeAZIcuQ
Answer a Call	POST	/v2/calls/{{callControlId}}/actions/answer	conn_mod_def::GMTgR1cJTDA::-8Sl2cgnQaWvXpTdtm6u0Q
Bridge Calls	POST	/v2/calls/{{callControlId}}/actions/bridge	conn_mod_def::GMTgR8lA5CA::nkIF1BvWQneFUWQHpnaCJg
Dial a Call	POST	/v2/calls	conn_mod_def::GMTgR-ergyA::KAPZ8ev6RYuHLp_dCO_png
Enqueue a Call	POST	/v2/calls/{{callControlId}}/actions/enqueue	conn_mod_def::GMTgR9WNSGg::ocQhOGSlThOU9XCXUcCLpA
Fork Start Using Calls Actions	POST	/v2/calls/{{callControlId}}/actions/fork_start	conn_mod_def::GMTgR9WhVTg::kqk5ceOGQKKDHGCUIFAeLQ
Gather for a Call	POST	/v2/calls/{{callControlId}}/actions/gather	conn_mod_def::GMTgSFsPz4g::vPvzUFC-T_imr5EpMHjDHw
Gather Using AI for a Call	POST	/v2/calls/{{callControlId}}/actions/gather_using_ai	conn_mod_def::GMTgSF4aGbg::iDRNqDu6SNCu6NhBT3M6yg

31 more Calls actions are available through search.

Conferences

Action	Method	Path	Action id
List an Account's Conference Resources	GET	/v2/texml/Accounts/{{accountSid}}/Conferences	conn_mod_def::GMTguUXKO2A::0dyKRd_ITVORGMaN5A0oLw
List Conferences	GET	/v2/conferences	conn_mod_def::GMTgVexvdyg::pqJLKJLlQB605cjmIc6_Kw
Retrieve a Conference	GET	/v2/conferences/{{id}}	conn_mod_def::GMTgVii0OOA::7xqRWsvORjaT5VqA6oXq2g
Create a Conference	POST	/v2/conferences	conn_mod_def::GMTgVFz0YCg::aC-6hxpXRiuZBFD4-XqeCA
End a Conference	POST	/v2/conferences/{{id}}/actions/end	conn_mod_def::GMTgVGXnOTA::FpzBNlEmSwu-zN5s3661ag
Gather Using Audio for a Conference	POST	/v2/conferences/{{id}}/actions/gather_using_audio	conn_mod_def::GMTgVRIWcnA::3loBqAvGQQa3iANEHZVfCQ
Hold Conference Participants	POST	/v2/conferences/{{id}}/actions/hold	conn_mod_def::GMTgVP8fFcg::1KytKW-FQ8-5y6wU-8VjYQ
Join a Call Leg to a Conference	POST	/v2/conferences/{{id}}/actions/join	conn_mod_def::GMTgVQQUxNg::pe_1NhDDRme2SPPOdixtJw
Leave a Conference	POST	/v2/conferences/{{id}}/actions/leave	conn_mod_def::GMTgVPc9pPA::PU_YTNgrTM2HB1HpxQzsfQ
Mute Conference Participants	POST	/v2/conferences/{{id}}/actions/mute	conn_mod_def::GMTgVX8vR7A::Iv1mum0GQ3qEDy-xTQ2ibQ
Pause Conference Recording	POST	/v2/conferences/{{id}}/actions/record_pause	conn_mod_def::GMTgU89z17A::Q-GMaxQnRWql9wxZ4qHFHw
Play Audio to a Conference

9 more Conferences actions are available through search.

PhoneNumbers

Action	Method	Path	Action id
List Phone Numbers	GET	/v2/phone_numbers	conn_mod_def::GMTgk0akCig::gRE3AFzES3uSCRrJdIRtoQ
List Phone Numbers for a DIR	GET	/v2/dir/{{dirId}}/phone_numbers	conn_mod_def::GMTgl-7wikA::biJS6TaJRueeI1ph6ai0ZQ
List Phone Numbers With Voice Settings	GET	/v2/phone_numbers/voice	conn_mod_def::GMTgkwpSfwA::oB6eX75wTUWkGSbn37SCmA
List Slim Phone Numbers	GET	/v2/phone_numbers/slim	conn_mod_def::GMTgk-aB0ig::3hbAD9GmTuuB6yFLjU7PKg
Retrieve a Phone Number	GET	/v2/phone_numbers/{{id}}	conn_mod_def::GMTgk8GwMTg::icgJmyOSSJOjP-OL0Dvibg
Retrieve Messaging Settings for a Phone Number	GET	/v2/phone_numbers/{{id}}/messaging	conn_mod_def::GMTgi0LbqVg::XwLR1eB3QGGYEczPa2OwTw
Retrieve Voice Settings for a Phone Number	GET	/v2/phone_numbers/{{id}}/voice	conn_mod_def::GMTgk7MoyUA::Rd2gBnqRQHGa8z_64A54KA
Change Bundle Status for a Phone Number	PATCH	/v2/phone_numbers/{{id}}/actions/bundle_status_change	conn_mod_def::GMTgkvwRqXA::RYSz8oPRSgSXae2WPosntg
Create CSV Download for Phone Numbers	POST	/v2/phone_numbers/csv_downloads	conn_mod_def::GMTgXTcXdsA::e4xgF7YcRiSnShKfr88gjQ
Delete a Batch of Phone Numbers	POST	/v2/phone_numbers/jobs/delete_phone_numbers	conn_mod_def::GMTgRsnA00g::DSmFvkORRV-QtCNcBQ4rcg
Delete a Phone Number	DELETE	/v2/phone_numbers/{{id}}	conn_mod_def::GMTgktnvSgA::g4Qzj1v8QqOsPCNQ9gCNtQ

5 more PhoneNumbers actions are available through search.

ExternalConnections

Action	Method	Path	Action id
Get Upload Status for an External Connection	GET	/v2/external_connections/{{id}}/uploads/status	conn_mod_def::GMTgbG4ddKg::mdJZN9ybQASGfOdU7Svs8A
List Civic Addresses for an External Connection	GET	/v2/external_connections/{{id}}/civic_addresses	conn_mod_def::GMTgbG-yuqg::1mzvR7xkQP656i1hnkPk1A
List External Connections	GET	/v2/external_connections	conn_mod_def::GMTgbOxu18A::Vbayv2fURUGMTqiyhpcGzw
List Releases for an External Connection	GET	/v2/external_connections/{{id}}/releases	conn_mod_def::GMTgbP-AGVA::BZAfQB74Q0StnYbayM97Sw
Retrieve a Civic Address for an External Connection	GET	/v2/external_connections/{{id}}/civic_addresses/{{addressId}}	conn_mod_def::GMTgbX5hApg::Pd8C16O6SIuEsYWJ6LSldQ
Retrieve a Phone Number for an External Connection	GET	/v2/external_connections/{{id}}/phone_numbers/{{phoneNumberId}}	conn_mod_def::GMTgbWcTpcg::Nklm-zInRO-qWN-PcDVHKg
Retrieve an External Connection	GET	/v2/external_connections/{{id}}	conn_mod_def::GMTgbgVQd5g::kthDlJ6ZQEetgA7r5xLcZg
Create an External Connection	POST	/v2/external_connections	conn_mod_def::GMTga_c2fag::Ll_IerNxTkWqW0ywjXYpNw
Create an Upload Request for an External Connection	POST	/v2/external_connections/{{id}}/uploads	conn_mod_def::GMTgbGukOzA::is5zGybVSrKQ0J2ZopICDQ
Delete an External Connection	DELETE	/v2/external_connections/{{id}}	conn_mod_def::GMTgbFyb7yA::Evchfl3lQ5mco0mPcn6phQ
Refresh Uploads for an External Connection	POST

3 more ExternalConnections actions are available through search.

PortingOrders

Action	Method	Path	Action id
Download a Porting Order LOA Template	GET	/v2/porting_orders/{{id}}/loa_template	conn_mod_def::GMTgmsFIS0g::1aRB5SuvTqWHalHes4Ym5A
Get a Porting Order's Sub Request	GET	/v2/porting_orders/{{id}}/sub_request	conn_mod_def::GMTgnlnZ-Vg::US1BFWeQQQ6Jd1uEGw9BKQ
List Allowed FOC Windows for a Porting Order	GET	/v2/porting_orders/{{id}}/allowed_foc_windows	conn_mod_def::GMTgnUifZSA::bmW-9p2JRuebKLs_69H4RA
List Porting Orders	GET	/v2/porting_orders	conn_mod_def::GMTgnNjwQRg::5-CZCwAbSkauOFa-yRsGEA
Retrieve a Porting Order	GET	/v2/porting_orders/{{id}}	conn_mod_def::GMTgnmlgpPg::rGizbYmhRYG6GF2UbBvE1w
Activate a Porting Order's Numbers	POST	/v2/porting_orders/{{id}}/actions/activate	conn_mod_def::GMTgl-cIrOA::cuRsZR-xR7-2-2qQtHBhDw
Cancel a Porting Order	POST	/v2/porting_orders/{{id}}/actions/cancel	conn_mod_def::GMTgmIhllug::3Ka56J1fRV6El94b8C5SIw
Confirm a Porting Order	POST	/v2/porting_orders/{{id}}/actions/confirm	conn_mod_def::GMTgnwu8fLg::ZZJ0UV6TTJGrR3UHex1kfA
Create a Porting Order	POST	/v2/porting_orders	conn_mod_def::GMTgmYEOrcA::BUtiKlQITWeZap11yo3oxg
Delete a Porting Order	DELETE	/v2/porting_orders/{{id}}	conn_mod_def::GMTgmizj78A::04THuMG-QAGWTqVKClKT7A
Delete an Additional Document for a Porting Order	DELETE	/v2/porting_orders/{{id}}/additional_documents/{{additionalDocumentId}}	conn_mod_def::GMTgmjRjtLA::6o-ofqLZRmyf8ASquBpuyA

3 more PortingOrders actions are available through search.

SimCards

Action	Method	Path	Action id
Get a SIM Card	GET	/v2/sim_cards/{{id}}	conn_mod_def::GMTgsgkWUOg::FaRT1kX9Q1S4-21YpR8OsQ
Get a SIM Card's Public IP	GET	/v2/sim_cards/{{id}}/public_ip	conn_mod_def::GMTgsduedDg::94o89vRXQvaIKoRtCeRa2A
Get Activation Code for a SIM Card	GET	/v2/sim_cards/{{id}}/activation_code	conn_mod_def::GMTgsUPrNAA::bkvbWi68RVullK-zve-3tA
List SIM Cards	GET	/v2/sim_cards	conn_mod_def::GMTgsWdpnRg::WupdsWFZQIqZ0LY6dIIeGA
Bulk Disable Voice for SIM Cards	POST	/v2/sim_cards/actions/bulk_disable_voice	conn_mod_def::GMTgsnBX0Xg::2IOBEDdpQ4KL-hCal_E1UQ
Bulk Set Public IPs for SIM Cards	POST	/v2/sim_cards/actions/bulk_set_public_ips	conn_mod_def::GMTgsxEgnYg::gI9O0wi5TweB7WsKxNNAcA
Delete a SIM Card	DELETE	/v2/sim_cards/{{id}}	conn_mod_def::GMTgsW_KxUA::3yj-PFgbR_ScgfsfAoTrCg
Disable a SIM Card	POST	/v2/sim_cards/{{id}}/actions/disable	conn_mod_def::GMTgsm5S4Yg::WAZK0byFTiyl-onZF-p3DA
Enable a SIM Card	POST	/v2/sim_cards/{{id}}/actions/enable	conn_mod_def::GMTgsmfNcog::KRinDeyvT7uZXV4ck8jnzA
Register SIM Cards	POST	/v2/actions/register/sim_cards	conn_mod_def::GMTgsog2vAA::vrjR0gJAQG-iB15zJy1NkA
Remove Public IP from a SIM Card	POST	/v2/sim_cards/{{id}}/actions/remove_public_ip	conn_mod_def::GMTgswXeQrg::vr3ls3ZKRr2qO4SkiNW1Lg
Set Public IP for a SIM Card	POST

3 more SimCards actions are available through search.

Messages

Action	Method	Path	Action id
Generate an RCS Deeplink	GET	/v2/messages/rcs/deeplinks/{{agentId}}	conn_mod_def::GMTgpWRHmtg::OfaCfyNhR7eoj9rzSe_pYg
Retrieve a Message	GET	/v2/messages/{{id}}	conn_mod_def::GMTgfZ9k6yA::CdoG2VdhQKOlb9B3U7UbzQ
Retrieve Group MMS Messages	GET	/v2/messages/group/{{messageId}}	conn_mod_def::GMTgfgaIKZg::M7P3sQtnRfKIAvFrENpdeA
Cancel a Message	DELETE	/v2/messages/{{id}}	conn_mod_def::GMTgfZyYt3g::XGvYs8q0THuPLNh4gov-1Q
Create an Anthropic-Compatible Message Using AI Anthropic v1	POST	/v2/ai/anthropic/v1/messages	conn_mod_def::GMTgORHX4_A::H7b7oiyBTZiFBoxob_wRRw
Schedule a Message	POST	/v2/messages/schedule	conn_mod_def::GMTgfh4sObg::iuqdk_lHS4uuQmiOcnQiVA
Send a Group MMS Message	POST	/v2/messages/group_mms	conn_mod_def::GMTgfg6J87A::Zf_Ot07xQVmI_eebBm5pjw
Send a Long Code Message	POST	/v2/messages/long_code	conn_mod_def::GMTgfhASPXg::dF8KNK02Tj2k0sZZI9KhCQ
Send a Message	POST	/v2/messages	conn_mod_def::GMTgfgqwatA::vqJStnx-SOWezABuxpAoxw
Send a Message Using Number Pool	POST	/v2/messages/number_pool	conn_mod_def::GMTgfpm79GA::j2x9HYGiTkymsV2L6OtX4Q
Send a Short Code Message	POST	/v2/messages/short_code	conn_mod_def::GMTgfpreFdA::sYAfxXCCQkqlmwVfIOErYA
Send a WhatsApp Message	POST	/v2/messages/whatsapp

2 more Messages actions are available through search.

Queues

Action	Method	Path	Action id
List Calls in a Queue	GET	/v2/queues/{{queueName}}/calls	conn_mod_def::GMTgpIBAuhg::VBqf6EJFRie9NLc3rG6igw
List Queue Resources for an Account	GET	/v2/texml/Accounts/{{accountSid}}/Queues	conn_mod_def::GMTguUnLhAg::Qu_4-VSOTciHq8iSVv0T_A
List Queues	GET	/v2/queues	conn_mod_def::GMTgpHKHjwA::ZPhuETJMRAG7Finwo72YnA
Retrieve a Call From a Queue	GET	/v2/queues/{{queueName}}/calls/{{callControlId}}	conn_mod_def::GMTgpH8TlFg::jIl2SMfwSq6IIk8sSMmnFw
Retrieve a Call Queue	GET	/v2/queues/{{queueName}}	conn_mod_def::GMTgpHLujjA::3ieC-QJkTryaGu6Yo2eWLw
Create a Queue	POST	/v2/queues	conn_mod_def::GMTgo_D6CAA::Y9wf9dydS-6xh6u60MA5vg

5 more Queues actions are available through search.

This lists 90 of 1163 actions. For anything not here, call search_one_platform_actions with platform telnyx. The full catalog is at https://www.withone.ai/knowledge/telnyx.

When a call fails

The error comes from Telnyx, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/telnyx

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.