Ai telnyx-account-notifications-curl

install

source · Clone the upstream repo

git clone https://github.com/team-telnyx/ai

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/team-telnyx/ai "$T" && mkdir -p ~/.claude/skills && cp -r "$T/providers/claude/plugin/skills/telnyx-account-notifications-curl" ~/.claude/skills/team-telnyx-ai-telnyx-account-notifications-curl && rm -rf "$T"

manifest: providers/claude/plugin/skills/telnyx-account-notifications-curl/SKILL.md

source content

Telnyx Account Notifications - curl

Installation

# curl is pre-installed on macOS, Linux, and Windows 10+

Setup

export TELNYX_API_KEY="YOUR_API_KEY_HERE"

All examples below use

$TELNYX_API_KEY

for authentication.

Error Handling

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

# Check HTTP status code in response
response=$(curl -s -w "\n%{http_code}" \
  -X POST "https://api.telnyx.com/v2/messages" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+13125550001", "from": "+13125550002", "text": "Hello"}')

http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | sed '$d')

case $http_code in
  2*) echo "Success: $body" ;;
  422) echo "Validation error — check required fields and formats" ;;
  429) echo "Rate limited — retry after delay"; sleep 1 ;;
  401) echo "Authentication failed — check TELNYX_API_KEY" ;;
  *)   echo "Error $http_code: $body" ;;
esac

Common error codes:

invalid API key,

insufficient permissions,

resource not found,

validation error (check field formats),

rate limited (retry with exponential backoff).

Important Notes

Pagination: List endpoints return paginated results. Use
```
page[number]
```
and
```
page[size]
```
query parameters to navigate pages. Check
```
meta.total_pages
```
in the response.

List notification channels

List notification channels.

GET /notification_channels

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_channels"

Returns:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

Create a notification channel

Create a notification channel.

POST /notification_channels

Optional:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "channel_type_id": "webhook",
      "channel_destination": "https://example.com/webhooks"
  }' \
  "https://api.telnyx.com/v2/notification_channels"

Returns:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

Get a notification channel

Get a notification channel.

GET /notification_channels/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_channels/550e8400-e29b-41d4-a716-446655440000"

Returns:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

Update a notification channel

Update a notification channel.

PATCH /notification_channels/{id}

Optional:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/notification_channels/550e8400-e29b-41d4-a716-446655440000"

Returns:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

Delete a notification channel

Delete a notification channel.

DELETE /notification_channels/{id}

curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/notification_channels/550e8400-e29b-41d4-a716-446655440000"

Returns:

channel_destination

(string),

channel_type_id

(enum: sms, voice, email, webhook),

created_at

(date-time),

id

(string),

notification_profile_id

(string),

updated_at

(date-time)

List all Notifications Events Conditions

Returns a list of your notifications events conditions.

GET /notification_event_conditions

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_event_conditions"

Returns:

allow_multiple_channels

(boolean),

associated_record_type

(enum: account, phone_number),

asynchronous

(boolean),

created_at

(date-time),

description

(string),

enabled

(boolean),

id

(string),

name

(string),

notification_event_id

(string),

parameters

(array[object]),

supported_channels

(array[string]),

updated_at

(date-time)

List all Notifications Events

Returns a list of your notifications events.

GET /notification_events

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_events"

Returns:

created_at

(date-time),

enabled

(boolean),

id

(string),

name

(string),

notification_category

(string),

updated_at

(date-time)

List all Notifications Profiles

Returns a list of your notifications profiles.

GET /notification_profiles

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_profiles"

Returns:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

Create a notification profile

Create a notification profile.

POST /notification_profiles

Optional:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "My Notification Profile"
  }' \
  "https://api.telnyx.com/v2/notification_profiles"

Returns:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

Get a notification profile

Get a notification profile.

GET /notification_profiles/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_profiles/550e8400-e29b-41d4-a716-446655440000"

Returns:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

Update a notification profile

Update a notification profile.

PATCH /notification_profiles/{id}

Optional:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

curl \
  -X PATCH \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/notification_profiles/550e8400-e29b-41d4-a716-446655440000"

Returns:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

Delete a notification profile

Delete a notification profile.

DELETE /notification_profiles/{id}

curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/notification_profiles/550e8400-e29b-41d4-a716-446655440000"

Returns:

created_at

(date-time),

id

(string),

name

(string),

updated_at

(date-time)

List notification settings

List notification settings.

GET /notification_settings

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_settings"

Returns:

associated_record_type

(string),

associated_record_type_value

(string),

created_at

(date-time),

id

(string),

notification_channel_id

(string),

notification_event_condition_id

(string),

notification_profile_id

(string),

parameters

(array[object]),

status

(enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted),

updated_at

(date-time)

Add a Notification Setting

Add a notification setting.

POST /notification_settings

Optional:

associated_record_type

(string),

associated_record_type_value

(string),

created_at

(date-time),

id

(string),

notification_channel_id

(string),

notification_event_condition_id

(string),

notification_profile_id

(string),

parameters

(array[object]),

status

(enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted),

updated_at

(date-time)

curl \
  -X POST \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.telnyx.com/v2/notification_settings"

Returns:

associated_record_type

(string),

associated_record_type_value

(string),

created_at

(date-time),

id

(string),

notification_channel_id

(string),

notification_event_condition_id

(string),

notification_profile_id

(string),

parameters

(array[object]),

status

(enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted),

updated_at

(date-time)

Get a notification setting

Get a notification setting.

GET /notification_settings/{id}

curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/notification_settings/550e8400-e29b-41d4-a716-446655440000"

Returns:

associated_record_type

(string),

associated_record_type_value

(string),

created_at

(date-time),

id

(string),

notification_channel_id

(string),

notification_event_condition_id

(string),

notification_profile_id

(string),

parameters

(array[object]),

status

(enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted),

updated_at

(date-time)

Delete a notification setting

Delete a notification setting.

DELETE /notification_settings/{id}

curl \
  -X DELETE \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/notification_settings/550e8400-e29b-41d4-a716-446655440000"

Returns:

associated_record_type

(string),

associated_record_type_value

(string),

created_at

(date-time),

id

(string),

notification_channel_id

(string),

notification_event_condition_id

(string),

notification_profile_id

(string),

parameters

(array[object]),

status

(enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted),

updated_at

(date-time)