Telnyx Messaging Profiles Python

---
name: telnyx-messaging-profiles-python
description: >-
  Create and manage messaging profiles with number pools, sticky sender, and
  geomatch features. Configure short codes for high-volume messaging. This skill
  provides Python SDK examples.
metadata:
  author: telnyx
  product: messaging-profiles
  language: python
---

# Telnyx Messaging Profiles - 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 messaging profiles

`GET /messaging_profiles`

```python
page = client.messaging_profiles.list()
page = page.data[0]
print(page.id)
```

## Create a messaging profile

`POST /messaging_profiles` — Required: `name`, `whitelisted_destinations`

```python
messaging_profile = client.messaging_profiles.create(
    name="My name",
    whitelisted_destinations=["US"],
)
print(messaging_profile.data)
```

## Retrieve a messaging profile

`GET /messaging_profiles/{id}`

```python
messaging_profile = client.messaging_profiles.retrieve(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(messaging_profile.data)
```

## Update a messaging profile

`PATCH /messaging_profiles/{id}`

```python
messaging_profile = client.messaging_profiles.update(
    messaging_profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(messaging_profile.data)
```

## Delete a messaging profile

`DELETE /messaging_profiles/{id}`

```python
messaging_profile = client.messaging_profiles.delete(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(messaging_profile.data)
```

## List phone numbers associated with a messaging profile

`GET /messaging_profiles/{id}/phone_numbers`

```python
page = client.messaging_profiles.list_phone_numbers(
    messaging_profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
page = page.data[0]
print(page.id)
```

## List short codes associated with a messaging profile

`GET /messaging_profiles/{id}/short_codes`

```python
page = client.messaging_profiles.list_short_codes(
    messaging_profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
page = page.data[0]
print(page.messaging_profile_id)
```

## List Auto-Response Settings

`GET /messaging_profiles/{profile_id}/autoresp_configs`

```python
autoresp_configs = client.messaging_profiles.autoresp_configs.list(
    profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(autoresp_configs.data)
```

## Create auto-response setting

`POST /messaging_profiles/{profile_id}/autoresp_configs` — Required: `op`, `keywords`, `country_code`

```python
auto_resp_config_response = client.messaging_profiles.autoresp_configs.create(
    profile_id="profile_id",
    country_code="US",
    keywords=["keyword1", "keyword2"],
    op="start",
)
print(auto_resp_config_response.data)
```

## Get Auto-Response Setting

`GET /messaging_profiles/{profile_id}/autoresp_configs/{autoresp_cfg_id}`

```python
auto_resp_config_response = client.messaging_profiles.autoresp_configs.retrieve(
    autoresp_cfg_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(auto_resp_config_response.data)
```

## Update Auto-Response Setting

`PUT /messaging_profiles/{profile_id}/autoresp_configs/{autoresp_cfg_id}` — Required: `op`, `keywords`, `country_code`

```python
auto_resp_config_response = client.messaging_profiles.autoresp_configs.update(
    autoresp_cfg_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    country_code="US",
    keywords=["keyword1", "keyword2"],
    op="start",
)
print(auto_resp_config_response.data)
```

## Delete Auto-Response Setting

`DELETE /messaging_profiles/{profile_id}/autoresp_configs/{autoresp_cfg_id}`

```python
autoresp_config = client.messaging_profiles.autoresp_configs.delete(
    autoresp_cfg_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    profile_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(autoresp_config)
```

## List short codes

`GET /short_codes`

```python
page = client.short_codes.list()
page = page.data[0]
print(page.messaging_profile_id)
```

## Retrieve a short code

`GET /short_codes/{id}`

```python
short_code = client.short_codes.retrieve(
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(short_code.data)
```

## Update short code

Update the settings for a specific short code.

`PATCH /short_codes/{id}` — Required: `messaging_profile_id`

```python
short_code = client.short_codes.update(
    id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    messaging_profile_id="abc85f64-5717-4562-b3fc-2c9600000000",
)
print(short_code.data)
```