Manage sub-accounts for reseller and enterprise scenarios. This skill provides Python SDK examples.
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
pip install telnyx
import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
public_key=os.environ.get("TELNYX_PUBLIC_KEY"), # Required for client.webhooks.unwrap() (webhook verification)
)
All examples below assume client is already initialized as shown above.
All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:
import telnyx
try:
result = client.messages.send(to="+13125550001", from_="+13125550002", text="Hello")
except telnyx.APIConnectionError:
print("Network error — check connectivity and retry")
raise
except telnyx.RateLimitError:
# 429: rate limited — wait, then retry the request (bounded exponential backoff)
import time
time.sleep(1) # Check Retry-After header for actual delay
# ...retry the call here (give up after a few attempts); otherwise re-raise:
raise
except telnyx.APIStatusError as e:
print(f"API error {e.status_code}: {e.message}")
if e.status_code == 422:
print("Validation error — check required fields and formats")
raise # A failed request must never look like success to the caller
Common error codes: 401 invalid API key, 403 insufficient permissions,
404 resource not found, 422 validation error (check field formats),
429 rate limited (retry with exponential backoff).
for item in page_result: to iterate through all pages automatically.Lists the accounts managed by the current user. Users need to be explictly approved by Telnyx in order to become manager accounts.
GET /managed_accounts
page = client.managed_accounts.list()
page = page.data[0]
print(page.id)
Returns: api_user (string), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
Create a new managed account owned by the authenticated user. You need to be explictly approved by Telnyx in order to become a manager account.
POST /managed_accounts — Required: business_name
Optional: email (string), managed_account_allow_custom_pricing (boolean), password (string), rollup_billing (boolean)
managed_account = client.managed_accounts.create(
business_name="Larry's Cat Food Inc",
)
print(managed_account.data)
Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
Display information about allocatable global outbound channels for the current user. Only usable by account managers.
GET /managed_accounts/allocatable_global_outbound_channels
response = client.managed_accounts.get_allocatable_global_outbound_channels()
print(response.data)
Returns: allocatable_global_outbound_channels (integer), managed_account_allow_custom_pricing (boolean), record_type (string), total_global_channels_allocated (integer)
Retrieves the details of a single managed account.
GET /managed_accounts/{id}
managed_account = client.managed_accounts.retrieve("550e8400-e29b-41d4-a716-446655440000",
)
print(managed_account.data)
Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
Updates the specified managed account's attributes and returns the updated account.
PATCH /managed_accounts/{id}
Optional: managed_account_allow_custom_pricing (boolean)
managed_account = client.managed_accounts.update(
id="550e8400-e29b-41d4-a716-446655440000",
)
print(managed_account.data)
Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
Disables a managed account, forbidding it to use Telnyx services, including sending or receiving phone calls and SMS messages. Ongoing phone calls will not be affected. The managed account and its sub-users will no longer be able to log in via the mission control portal.
POST /managed_accounts/{id}/actions/disable
response = client.managed_accounts.actions.disable("550e8400-e29b-41d4-a716-446655440000",
)
print(response.data)
Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
Enables a managed account and its sub-users to use Telnyx services.
POST /managed_accounts/{id}/actions/enable
Optional: reenable_all_connections (boolean)
response = client.managed_accounts.actions.enable(
id="550e8400-e29b-41d4-a716-446655440000",
)
print(response.data)
Returns: api_key (string), api_token (string), api_user (string), balance (object), created_at (string), email (email), id (uuid), managed_account_allow_custom_pricing (boolean), manager_account_id (string), organization_name (string), record_type (enum: managed_account), rollup_billing (boolean), updated_at (string)
PATCH /managed_accounts/{id}/update_global_channel_limit
Optional: channel_limit (integer)
response = client.managed_accounts.update_global_channel_limit(
id="550e8400-e29b-41d4-a716-446655440000",
)
print(response.data)
Returns: channel_limit (integer), email (string), id (string), manager_account_id (string), record_type (string)
Returns a list of the users in your organization.
GET /organizations/users
page = client.organizations.users.list()
page = page.data[0]
print(page.id)
Returns: created_at (string), email (email), groups (array[object]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)
Returns a report of all users in your organization with their group memberships. This endpoint returns all users without pagination and always includes group information. The report can be retrieved in JSON or CSV format by sending specific content-type headers.
GET /organizations/users/users_groups_report
response = client.organizations.users.get_groups_report()
print(response.data)
Returns: created_at (string), email (email), groups (array[object]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)
Returns the details of a user in your organization, optionally including the groups the user belongs to.
GET /organizations/users/{id}
user = client.organizations.users.retrieve(
id="550e8400-e29b-41d4-a716-446655440000",
)
print(user.data)
Returns: created_at (string), email (email), groups (array[object]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)
Removes the specified user from your organization and returns the result of the removal.
POST /organizations/users/{id}/actions/remove
action = client.organizations.users.actions.remove("550e8400-e29b-41d4-a716-446655440000",
)
print(action.data)
Returns: created_at (string), email (email), groups (array[object]), id (string), last_sign_in_at (string | null), organization_user_bypasses_sso (boolean), record_type (string), user_status (enum: enabled, disabled, blocked)
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Test VoIP push notifications for Telnyx WebRTC iOS (APNs) and Android (FCM) apps. Use when debugging push notification delivery, validating certificate/credential setup, or testing that a device receives VoIP pushes correctly.
中文简介正在准备中。当前显示原文说明。
10DLC brand and campaign registration for US A2P messaging compliance. Assign phone numbers to campaigns.
中文简介正在准备中。当前显示原文说明。
10DLC brand and campaign registration for US A2P messaging compliance. Assign phone numbers to campaigns.
中文简介正在准备中。当前显示原文说明。
10DLC brand and campaign registration for US A2P messaging compliance. Assign phone numbers to campaigns.
中文简介正在准备中。当前显示原文说明。
10DLC brand and campaign registration for US A2P messaging compliance. Assign phone numbers to campaigns.
中文简介正在准备中。当前显示原文说明。
10DLC brand and campaign registration for US A2P messaging compliance. Assign phone numbers to campaigns.
中文简介正在准备中。当前显示原文说明。