Configure account addresses, authentication providers, IP access controls, billing groups, and integration secrets. This skill provides Python SDK examples.
Scanned 2/12/2026
Install via CLI
Skills Directoryopenskills install team-telnyx/telnyx-ext-agent-skills---
name: telnyx-account-access-python
description: >-
Configure account addresses, authentication providers, IP access controls,
billing groups, and integration secrets. This skill provides Python SDK
examples.
metadata:
author: telnyx
product: account-access
language: python
---
# Telnyx Account Access - Python
## Installation
```bash
pip install telnyx
```
## Setup
```python
import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
```
All examples below assume `client` is already initialized as shown above.
## List all addresses
Returns a list of your addresses.
`GET /addresses`
```python
page = client.addresses.list()
page = page.data[0]
print(page.id)
```
## Creates an address
Creates an address.
`POST /addresses` — Required: `first_name`, `last_name`, `business_name`, `street_address`, `locality`, `country_code`
```python
address = client.addresses.create(
business_name="Toy-O'Kon",
country_code="US",
first_name="Alfred",
last_name="Foster",
locality="Austin",
street_address="600 Congress Avenue",
)
print(address.data)
```
## Retrieve an address
Retrieves the details of an existing address.
`GET /addresses/{id}`
```python
address = client.addresses.retrieve(
"id",
)
print(address.data)
```
## Deletes an address
Deletes an existing address.
`DELETE /addresses/{id}`
```python
address = client.addresses.delete(
"id",
)
print(address.data)
```
## Accepts this address suggestion as a new emergency address for Operator Connect and finishes the uploads of the numbers associated with it to Microsoft.
`POST /addresses/{id}/actions/accept_suggestions`
```python
response = client.addresses.actions.accept_suggestions(
address_uuid="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response.data)
```
## Validate an address
Validates an address for emergency services.
`POST /addresses/actions/validate` — Required: `country_code`, `street_address`, `postal_code`
```python
response = client.addresses.actions.validate(
country_code="US",
postal_code="78701",
street_address="600 Congress Avenue",
)
print(response.data)
```
## List all SSO authentication providers
Returns a list of your SSO authentication providers.
`GET /authentication_providers`
```python
page = client.authentication_providers.list()
page = page.data[0]
print(page.id)
```
## Creates an authentication provider
Creates an authentication provider.
`POST /authentication_providers` — Required: `name`, `short_name`, `settings`
```python
authentication_provider = client.authentication_providers.create(
name="Okta",
settings={
"idp_cert_fingerprint": "13:38:C7:BB:C9:FF:4A:70:38:3A:E3:D9:5C:CD:DB:2E:50:1E:80:A7",
"idp_entity_id": "https://myorg.myidp.com/saml/metadata",
"idp_sso_target_url": "https://myorg.myidp.com/trust/saml2/http-post/sso",
},
short_name="myorg",
)
print(authentication_provider.data)
```
## Retrieve an authentication provider
Retrieves the details of an existing authentication provider.
`GET /authentication_providers/{id}`
```python
authentication_provider = client.authentication_providers.retrieve(
"id",
)
print(authentication_provider.data)
```
## Update an authentication provider
Updates settings of an existing authentication provider.
`PATCH /authentication_providers/{id}`
```python
authentication_provider = client.authentication_providers.update(
id="id",
active=True,
name="Okta",
settings={
"idp_entity_id": "https://myorg.myidp.com/saml/metadata",
"idp_sso_target_url": "https://myorg.myidp.com/trust/saml2/http-post/sso",
"idp_cert_fingerprint": "13:38:C7:BB:C9:FF:4A:70:38:3A:E3:D9:5C:CD:DB:2E:50:1E:80:A7",
"idp_cert_fingerprint_algorithm": "sha1",
},
short_name="myorg",
)
print(authentication_provider.data)
```
## Deletes an authentication provider
Deletes an existing authentication provider.
`DELETE /authentication_providers/{id}`
```python
authentication_provider = client.authentication_providers.delete(
"id",
)
print(authentication_provider.data)
```
## List all billing groups
`GET /billing_groups`
```python
page = client.billing_groups.list()
page = page.data[0]
print(page.id)
```
## Create a billing group
`POST /billing_groups`
```python
billing_group = client.billing_groups.create(
name="string",
)
print(billing_group.data)
```
## Get a billing group
`GET /billing_groups/{id}`
```python
billing_group = client.billing_groups.retrieve(
"f5586561-8ff0-4291-a0ac-84fe544797bd",
)
print(billing_group.data)
```
## Update a billing group
`PATCH /billing_groups/{id}`
```python
billing_group = client.billing_groups.update(
id="f5586561-8ff0-4291-a0ac-84fe544797bd",
name="string",
)
print(billing_group.data)
```
## Delete a billing group
`DELETE /billing_groups/{id}`
```python
billing_group = client.billing_groups.delete(
"f5586561-8ff0-4291-a0ac-84fe544797bd",
)
print(billing_group.data)
```
## List integration secrets
Retrieve a list of all integration secrets configured by the user.
`GET /integration_secrets`
```python
page = client.integration_secrets.list()
page = page.data[0]
print(page.id)
```
## Create a secret
Create a new secret with an associated identifier that can be used to securely integrate with other services.
`POST /integration_secrets` — Required: `identifier`, `type`
```python
integration_secret = client.integration_secrets.create(
identifier="my_secret",
type="bearer",
token="my_secret_value",
)
print(integration_secret.data)
```
## Delete an integration secret
Delete an integration secret given its ID.
`DELETE /integration_secrets/{id}`
```python
client.integration_secrets.delete(
"id",
)
```
## List all Access IP Addresses
`GET /access_ip_address`
```python
page = client.access_ip_address.list()
page = page.data[0]
print(page.id)
```
## Create new Access IP Address
`POST /access_ip_address` — Required: `ip_address`
```python
access_ip_address_response = client.access_ip_address.create(
ip_address="ip_address",
)
print(access_ip_address_response.id)
```
## Retrieve an access IP address
`GET /access_ip_address/{access_ip_address_id}`
```python
access_ip_address_response = client.access_ip_address.retrieve(
"access_ip_address_id",
)
print(access_ip_address_response.id)
```
## Delete access IP address
`DELETE /access_ip_address/{access_ip_address_id}`
```python
access_ip_address_response = client.access_ip_address.delete(
"access_ip_address_id",
)
print(access_ip_address_response.id)
```
## List all Access IP Ranges
`GET /access_ip_ranges`
```python
page = client.access_ip_ranges.list()
page = page.data[0]
print(page.id)
```
## Create new Access IP Range
`POST /access_ip_ranges` — Required: `cidr_block`
```python
access_ip_range = client.access_ip_ranges.create(
cidr_block="cidr_block",
)
print(access_ip_range.id)
```
## Delete access IP ranges
`DELETE /access_ip_ranges/{access_ip_range_id}`
```python
access_ip_range = client.access_ip_ranges.delete(
"access_ip_range_id",
)
print(access_ip_range.id)
```
No comments yet. Be the first to comment!
