# Telnyx

Telnyx is a communications platform offering voice, messaging, and data services through a global private network.

- **Category:** phone & sms
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 30
- **Triggers:** 0
- **Slug:** `TELNYX`
- **Version:** 20260413_00

## Tools

### Create Network

**Slug:** `TELNYX_CREATE_NETWORK`

Tool to create a new network. Use when you need to provision a fresh network resource before connecting devices.

### Create Notification Channel

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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_CHANNEL, as channel creation requires the notification_profile_id returned by this tool.

### Create Notification Setting

**Slug:** `TELNYX_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 portable across accounts.

### Delete Network

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_LIST_MESSAGING_PROFILES`

Tool to list messaging profiles. Use when you need to retrieve messaging profiles with optional pagination.

### List Messaging URL Domains

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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 stale IDs silently prevent events (e.g., call routing, recording) from reaching the webhook.

### List Notification Profiles

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_LIST_SSO_AUTHENTICATION_PROVIDERS`

Tool to retrieve all configured SSO authentication providers. Use after authenticating to enumerate your organization's SSO providers.

### Retrieve Network

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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

**Slug:** `TELNYX_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.
