OpenSkillIndex← back to search
claude-code

Ai telnyx-messaging-profiles-go

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-messaging-profiles-go" ~/.claude/skills/team-telnyx-ai-telnyx-messaging-profiles-go && rm -rf "$T"
manifest: providers/claude/plugin/skills/telnyx-messaging-profiles-go/SKILL.md
source content
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->

Telnyx Messaging Profiles - Go

Installation

go get github.com/team-telnyx/telnyx-go

Setup

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

All examples below assume 

client
is already initialized as shown above.

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:

import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}

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).

Important Notes

  • Pagination: Use 
    ListAutoPaging()
    for automatic iteration: 
    iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }
    .

List messaging profiles

GET /messaging_profiles

	page, err := client.MessagingProfiles.List(context.Background(), telnyx.MessagingProfileListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
organization_id
(string), 
record_type
(enum: messaging_profile), 
redaction_enabled
(boolean), 
redaction_level
(integer), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

Create a messaging profile

POST /messaging_profiles
— Required: 
name
, 
whitelisted_destinations

Optional: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
number_pool_settings
(object | null), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
url_shortener_settings
(object | null), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url)

	messagingProfile, err := client.MessagingProfiles.New(context.Background(), telnyx.MessagingProfileNewParams{
		Name:                    "My name",
		WhitelistedDestinations: []string{"US"},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Returns: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
organization_id
(string), 
record_type
(enum: messaging_profile), 
redaction_enabled
(boolean), 
redaction_level
(integer), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

Retrieve a messaging profile

GET /messaging_profiles/{id}

	messagingProfile, err := client.MessagingProfiles.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Returns: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
organization_id
(string), 
record_type
(enum: messaging_profile), 
redaction_enabled
(boolean), 
redaction_level
(integer), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

Update a messaging profile

PATCH /messaging_profiles/{id}

Optional: 

alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
record_type
(enum: messaging_profile), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

	messagingProfile, err := client.MessagingProfiles.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileUpdateParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Returns: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
organization_id
(string), 
record_type
(enum: messaging_profile), 
redaction_enabled
(boolean), 
redaction_level
(integer), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

Delete a messaging profile

DELETE /messaging_profiles/{id}

	messagingProfile, err := client.MessagingProfiles.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Returns: 

ai_assistant_id
(string | null), 
alpha_sender
(string | null), 
created_at
(date-time), 
daily_spend_limit
(string), 
daily_spend_limit_enabled
(boolean), 
enabled
(boolean), 
health_webhook_url
(url), 
id
(uuid), 
mms_fall_back_to_sms
(boolean), 
mms_transcoding
(boolean), 
mobile_only
(boolean), 
name
(string), 
number_pool_settings
(object | null), 
organization_id
(string), 
record_type
(enum: messaging_profile), 
redaction_enabled
(boolean), 
redaction_level
(integer), 
resource_group_id
(string | null), 
smart_encoding
(boolean), 
updated_at
(date-time), 
url_shortener_settings
(object | null), 
v1_secret
(string), 
webhook_api_version
(enum: 1, 2, 2010-04-01), 
webhook_failover_url
(url), 
webhook_url
(url), 
whitelisted_destinations
(array[string])

List phone numbers associated with a messaging profile

GET /messaging_profiles/{id}/phone_numbers

	page, err := client.MessagingProfiles.ListPhoneNumbers(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileListPhoneNumbersParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: 

country_code
(string), 
created_at
(date-time), 
eligible_messaging_products
(array[string]), 
features
(object), 
health
(object), 
id
(string), 
messaging_product
(string), 
messaging_profile_id
(string | null), 
organization_id
(string), 
phone_number
(string), 
record_type
(enum: messaging_phone_number, messaging_settings), 
tags
(array[string]), 
traffic_type
(string), 
type
(enum: long-code, toll-free, short-code, longcode, tollfree, shortcode), 
updated_at
(date-time)

List short codes associated with a messaging profile

GET /messaging_profiles/{id}/short_codes

	page, err := client.MessagingProfiles.ListShortCodes(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileListShortCodesParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: 

country_code
(string), 
created_at
(date-time), 
id
(uuid), 
messaging_profile_id
(string | null), 
record_type
(enum: short_code), 
short_code
(string), 
tags
(array), 
updated_at
(date-time)

List short codes

GET /short_codes

	page, err := client.ShortCodes.List(context.Background(), telnyx.ShortCodeListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: 

country_code
(string), 
created_at
(date-time), 
id
(uuid), 
messaging_profile_id
(string | null), 
record_type
(enum: short_code), 
short_code
(string), 
tags
(array), 
updated_at
(date-time)

Retrieve a short code

GET /short_codes/{id}

	shortCode, err := client.ShortCodes.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", shortCode.Data)

Returns: 

country_code
(string), 
created_at
(date-time), 
id
(uuid), 
messaging_profile_id
(string | null), 
record_type
(enum: short_code), 
short_code
(string), 
tags
(array), 
updated_at
(date-time)

Update short code

Update the settings for a specific short code. To unbind a short code from a profile, set the 

messaging_profile_id
to 
null
or an empty string. To add or update tags, include the tags field as an array of strings.

PATCH /short_codes/{id}
— Required: 
messaging_profile_id

Optional: 

tags
(array)

	shortCode, err := client.ShortCodes.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.ShortCodeUpdateParams{
			MessagingProfileID: "abc85f64-5717-4562-b3fc-2c9600000000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", shortCode.Data)

Returns: 

country_code
(string), 
created_at
(date-time), 
id
(uuid), 
messaging_profile_id
(string | null), 
record_type
(enum: short_code), 
short_code
(string), 
tags
(array), 
updated_at
(date-time)