Telnyx is a communications platform offering voice, messaging, and data services through a global private network.
Telnyx is a communications platform offering voice, messaging, and data services through a global private network. On Nagent, Telnyx is exposed as a fully-configurable phone & sms integration that any agent can call — 30 actions, and API key authentication. No code is required to wire Telnyx into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Telnyx to automate the kinds of tasks phone & sms teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Telnyx into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Telnyx, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TELNYX_CREATE_NETWORKTool to create a new network. Use when you need to provision a fresh network resource before connecting devices.
Input parameters
A user-specified name for the network. Must be unique within your Telnyx account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_CREATE_NOTIFICATION_CHANNELTool 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.
Input parameters
Type of channel. Must be one of 'sms', 'voice', 'email', or 'webhook'.
Destination for the channel (e.g., phone number, email address, or webhook URL). For 'webhook' channels, the URL must be publicly reachable by Telnyx.
A UUID reference to the associated Notification Profile. The profile must already exist; call TELNYX_CREATE_NOTIFICATION_PROFILE first to obtain this UUID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_CREATE_NOTIFICATION_PROFILETool 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_CHANNEL, as channel creation requires the notification_profile_id returned by this tool.
Input parameters
A human-readable name for the notification profile.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_CREATE_NOTIFICATION_SETTINGTool 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 portable across accounts.
Input parameters
Optional list of key/value parameters for this notification setting.
UUID reference to the associated Notification Channel.
UUID reference to the associated Notification Profile.
UUID reference to the associated Notification Event Condition.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_DELETE_NETWORKTool to delete a network by ID. Use when you have obtained the network's identifier and need to remove it permanently.
Input parameters
Unique identifier for the network to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_DELETE_NOTIFICATION_CHANNELTool to delete a notification channel by ID. Use when you have the channel's identifier and need to remove it permanently.
Input parameters
Unique identifier for the notification channel to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_DELETE_NOTIFICATION_PROFILETool to delete a notification profile by ID. Use when you have the profile's identifier and need to remove it permanently.
Input parameters
Unique identifier for the notification profile to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_DELETE_NOTIFICATION_SETTINGTool to delete a notification setting by ID. Use when you need to permanently remove an existing notification setting before reconfiguration.
Input parameters
Unique identifier for the notification setting to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_GET_BLACK_BOX_TEST_RESULTSTool 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.
Input parameters
Filter parameters for black box test results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_GET_USER_BALANCETool to retrieve the current user account balance and credit details. Use after authenticating your account to check available balance.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_AUDIT_LOGSTool 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.
Input parameters
Sort order of results by creation date: 'asc' or 'desc'.
Number of items per page.
Page number to load (must be ≥ 1).
Filter for audit events created after this ISO 8601 timestamp.
Filter for audit events created before this ISO 8601 timestamp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_CONNECTIONSTool to retrieve all connections in your account. Use when you need to list connections with pagination, filtering, and sorting.
Input parameters
Specifies sort order: `created_at`, `connection_name`, or `active`. Prefix with '-' for descending, e.g., '-connection_name'.
Size of the page. Default is 250. Must be between 1 and 250.
Page number to load. Default is 1. Must be ≥ 1.
If present, returns connections with `connection_name` containing the given value. Case-insensitive; requires at least three characters.
Identifies the associated outbound voice profile.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_DYNAMIC_EMERGENCY_ENDPOINTSTool 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".
Input parameters
Filter by endpoint status. Possible values: 'pending', 'activated', 'rejected'.
Number of items per page (1–250).
Page number to load (must be >= 1).
Filter by ISO 3166-1 alpha-2 country code (e.g., 'US', 'CA').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_GLOBAL_IP_HEALTH_CHECK_TYPESTool to list all available global IP health check types. Use when you need to retrieve supported health check types for global IP configurations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_MESSAGING_PROFILESTool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.
Input parameters
Number of results per page (1–250).
Page number for pagination (starts at 1).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_MESSAGING_URL_DOMAINSTool to list configured messaging URL domains. Use when you need to retrieve messaging URL domains for a profile.
Input parameters
Number of results per page. Defaults to 20; max is 100.
Page number for pagination. Defaults to 1.
Filter by messaging profile ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_MOBILE_NETWORK_OPERATORSTool to list available mobile network operators. Use when you need to discover operators optionally filtered by country code, operator name, or with pagination.
Input parameters
Number of results per page (maximum 100).
Page number for pagination (starting at 1).
Filter operators by country code (ISO 3166-1 alpha-2).
Filter operators by operator name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NETWORK_INTERFACESTool to list all network interfaces for a specified network. Use after retrieving a network's ID to enumerate its interfaces.
Input parameters
Number of results per page. Default is 20. Must be between 1 and 250.
Unique identifier (UUID) of the network to list interfaces for.
Filter results by interface name.
Filter results by interface type.
Page number to load. Default is 1. Must be ≥ 1.
Filter results by interface status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NETWORKSTool to list all networks in your account. Use when you need to retrieve networks with optional pagination and filtering.
Input parameters
Size of the page. Default is 20. Must be ≥ 1.
Filter results by network name.
Page number to load. Default is 1. Must be ≥ 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NOTIFICATION_CHANNELSTool to list all notification channels. Use when you need to retrieve and paginate existing notification channels, optionally filtering by channel type.
Input parameters
Number of results per page. Defaults to 20; max is 100.
Page number for pagination. Defaults to 1.
Filter by the ID of the channel type. Possible values: 'webhook', 'sms', 'email', 'voice'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NOTIFICATION_EVENT_CONDITIONSTool to list all notification event conditions. Use when you need to retrieve and paginate notification event conditions, optionally filtering by associated record type.
Input parameters
Number of results per page. Defaults to 20; max is 250.
Page number for pagination. Defaults to 1.
Filter by associated record type. Allowed values: 'account', 'phone_number'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NOTIFICATION_EVENTSTool 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 stale IDs silently prevent events (e.g., call routing, recording) from reaching the webhook.
Input parameters
Number of results per page (1–250). Defaults to 20.
Page number to load (must be ≥ 1). Defaults to 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_NOTIFICATION_PROFILESTool to list all notification profiles. Use when you need to retrieve and paginate your notification profiles with optional pagination.
Input parameters
Number of results per page. Defaults to 20.
Page number for pagination. Defaults to 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_PHONE_NUMBERSTool to list phone numbers associated with your account. Use when you need to retrieve and filter your phone numbers with optional pagination and sorting.
Input parameters
Comma-separated list of fields to sort by (e.g., 'phone_number').
Results per page; maximum 1000.
Page number for results pagination (starts at 1).
Filter numbers by status (e.g., 'ported_in', 'ported_away', 'provisioned').
Return numbers matching this E.164 phone number format.
Filter numbers by associated connection ID.
Return numbers with this National Destination Code (NDC).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_LIST_SSO_AUTHENTICATION_PROVIDERSTool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.
Input parameters
Sort order for results. Prefix field with '-' for descending order.
Size of the page. Must be between 1 and 250.
The page number to load. Must be ≥ 1.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_RETRIEVE_NETWORKTool 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.
Input parameters
Unique identifier (UUID) of the network to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_RETRIEVE_NOTIFICATION_CHANNELTool to retrieve a notification channel by ID. Use after you have a channel ID and need its details, such as name, type, and status.
Input parameters
Unique identifier of the notification channel to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_RETRIEVE_NOTIFICATION_PROFILETool to retrieve a notification profile by ID. Use after obtaining the profile ID when you need details about its webhook endpoints and subscribed events.
Input parameters
Unique identifier of the notification profile to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_RETRIEVE_NOTIFICATION_SETTINGTool 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.
Input parameters
Unique identifier of the notification setting to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TELNYX_UPDATE_NETWORKTool to update details of an existing network. Use when you have a network's identifier and need to modify its name or tags.
Input parameters
New name for the network.
List of tags to assign to the network.
Unique identifier for the network to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 30 agents privately built on Nagent that already use Telnyx.
Build on Nagent
Connect Telnyx to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Telnyx, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Telnyx is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Telnyx is connected, you configure its 30 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Telnyx steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Telnyx event fires, the agent kicks off automatically.
Every Telnyx action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Telnyx ships with 30 pre-built phone & sms actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Telnyx together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Telnyx-based workflows tailored to your business.