Connect Telnyx to your AI agent
Telnyx is a communications platform offering voice, messaging, and data services through a global private network.
We set up the connection using your own Telnyx account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Telnyx
Each one is a real action the agent can take on its own, the same things a person clicking around Telnyx could do. Read-only by default; write actions are confirmed against your policy.
- Create Network Tool to create a new network. Use when you need to provision a fresh network resource before connecting devices.
- Create Notification Channel Tool to create a notification channel. Use when you need to register a channel (SMS, voice, email, or webhook) to receive notifications. E.g., create a webhook channel for event callbacks.
- Create Notification Profile Tool to create a notification profile. Use when you need to register a new profile to group notification channels (SMS and voice) and define notification settings. Must be called before TELNYX_CREATE_NOTIFICATION_CHANNE…
- Create Notification Setting Tool to add a notification setting. Use after creating the event condition, profile, and channel. All three UUID parameters must be fetched dynamically from their respective list/create endpoints; hardcoded IDs are not…
- Delete Network Tool to delete a network by ID. Use when you have obtained the network's identifier and need to remove it permanently.
- Delete Notification Channel Tool to delete a notification channel by ID. Use when you have the channel's identifier and need to remove it permanently.
- Delete Notification Profile Tool to delete a notification profile by ID. Use when you have the profile's identifier and need to remove it permanently.
- Delete Notification Setting Tool to delete a notification setting by ID. Use when you need to permanently remove an existing notification setting before reconfiguration.
- Get Black Box Test Results Tool to retrieve black box test results from Telnyx SETI Observability. Use when you need to check service health and test results, optionally filtering by product.
- Get User Balance Tool to retrieve the current user account balance and credit details. Use after authenticating your account to check available balance.
- List Audit Logs Tool to retrieve a list of audit log entries for your account. Use when you need to review recent resource changes with optional pagination and date filters.
- List Connections Tool to retrieve all connections in your account. Use when you need to list connections with pagination, filtering, and sorting.
- List Dynamic Emergency Endpoints Tool to list dynamic emergency endpoints. Use when you need to retrieve dynamic emergency endpoint records, optionally filtered by status or country. Example: "List all activated endpoints in US".
- List Global IP Health Check Types Tool to list all available global IP health check types. Use when you need to retrieve supported health check types for global IP configurations.
- List Messaging Profiles Tool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.
- List Messaging URL Domains Tool to list configured messaging URL domains. Use when you need to retrieve messaging URL domains for a profile.
- List Mobile Network Operators Tool to list available mobile network operators. Use when you need to discover operators optionally filtered by country code, operator name, or with pagination.
- List Network Interfaces Tool to list all network interfaces for a specified network. Use after retrieving a network's ID to enumerate its interfaces.
- List Networks Tool to list all networks in your account. Use when you need to retrieve networks with optional pagination and filtering.
- List Notification Channels Tool to list all notification channels. Use when you need to retrieve and paginate existing notification channels, optionally filtering by channel type.
- List Notification Event Conditions Tool to list all notification event conditions. Use when you need to retrieve and paginate notification event conditions, optionally filtering by associated record type.
- List Notification Events Tool to list all notification events with their IDs. Use to dynamically retrieve notification_event_condition_id values before configuring webhook subscriptions — IDs are account-specific and must not be hardcoded, as s…
- List Notification Profiles Tool to list all notification profiles. Use when you need to retrieve and paginate your notification profiles with optional pagination.
- List Phone Numbers Tool to list phone numbers associated with your account. Use when you need to retrieve and filter your phone numbers with optional pagination and sorting.
- List SSO Authentication Providers Tool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.
- Retrieve Network Tool to retrieve details of a specific network by ID. Use after obtaining the network's identifier to fetch its current attributes before update or delete operations.
- Retrieve Notification Channel Tool to retrieve a notification channel by ID. Use after you have a channel ID and need its details, such as name, type, and status.
- Retrieve Notification Profile Tool to retrieve a notification profile by ID. Use after obtaining the profile ID when you need details about its webhook endpoints and subscribed events.
- Retrieve Notification Setting Tool to retrieve a notification setting by ID. Use after obtaining the notification setting ID to fetch its details, such as status, parameters, and associated channel.
- Update Network Tool to update details of an existing network. Use when you have a network's identifier and need to modify its name or tags.
Setup
How we connect it
- 1
Connect your account
You create a key in Telnyx, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Telnyx questions, answered.
With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions Telnyx's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Telnyx to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Telnyx.