withoneai 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
- Find the action in the table below, or call
search_one_platform_actionswith platformtelnyxif it is not listed. - Call
get_one_action_knowledgewith the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. - Call
execute_one_actionwith 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 |
| Gather Using Audio for a Call | POST | /v2/calls/{{callControlId}}/actions/gather_using_audio |
conn_mod_def::GMTgSFUpZ3g::ZjZ9HGrLR8ileD9P23jE8A |
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 | POST | /v2/conferences/{{id}}/actions/play |
conn_mod_def::GMTgVX33POA::VJ9Nr_C-SoSuraLos3w59Q |
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 |
| Enable Emergency for a Phone Number | POST | /v2/phone_numbers/{{id}}/actions/enable_emergency |
conn_mod_def::GMTgktdJU2g::hLeasHiTSFeITKja2wkk5g |
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 | /v2/external_connections/{{id}}/uploads/refresh |
conn_mod_def::GMTgbY_TA3g::lx89ndLEQTmfJ6iLarmcAQ |
| Retry an Upload for an External Connection | POST | /v2/external_connections/{{id}}/uploads/{{ticketId}}/retry |
conn_mod_def::GMTgbh3EWtg::UXSB0yiCRNOIGQHLNCPnEA |
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 |
| Edit a Porting Order | PATCH | /v2/porting_orders/{{id}} |
conn_mod_def::GMTgmsDgXdA::wOs1orj9QBCb6FNRtumYCw |
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 | /v2/sim_cards/{{id}}/actions/set_public_ip |
conn_mod_def::GMTgsw-0AbA::ss8yViYUQWWi2l96QLpA2A |
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 |
conn_mod_def::GMTgyVp9Zlg::WEnpQvhNRQ-f5BTjbHhMQQ |
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.