Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Telnyx Account Notifications - Go · team-telnyx | DecimalAI

team-telnyx/telnyx-account-notifications-go

SkillScore100Maintained

Configure notification channels and settings for account alerts and events. This skill provides Go SDK examples.

codingby team-telnyx

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/team-telnyx-telnyx-account-notifications-go/SKILL.md

decimalai skills pull team-telnyx-telnyx-account-notifications-go --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/team-telnyx-telnyx-account-notifications-go/SKILL.md https://app.decimal.ai/s/team-telnyx-telnyx-account-notifications-go/SKILL.md

Raw file: /s/team-telnyx-telnyx-account-notifications-go/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-account-notifications-go.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +68% lift · at higher cost+139% tokens0% turns100% of whole cases pass with skill (22/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-03	✗→✓	▲ Improved	43%	0%
case-01	✗→✓	▲ Improved	59%	0%
case-02	✗→✓	▲ Improved	102%	0%
case-05	✗→✓	▲ Improved	127%	0%
case-10	✗→✓	▲ Improved	323%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

team-telnyx / ai

skills/telnyx-account-notifications-go/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v1

Skill contents

SKILL.md

Telnyx Account Notifications - Go

Installation

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

Setup

go
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:

go
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 notification channels

List notification channels.

GET /notification_channels

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

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)

go
	notificationChannel, err := client.NotificationChannels.New(context.Background(), telnyx.NotificationChannelNewParams{
		ChannelTypeID: "550e8400-e29b-41d4-a716-446655440000",
		ChannelDestination: "https://example.com/webhooks",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", notificationChannel.Data)

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}

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

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)

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

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}

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

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

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

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 (arrayobject]), supported_channels (arraystring]), updated_at (date-time)

List all Notifications Events

Returns a list of your notifications events.

GET /notification_events

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

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

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

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)

go
	notificationProfile, err := client.NotificationProfiles.New(context.Background(), telnyx.NotificationProfileNewParams{
		Name: "My Notification Profile",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", notificationProfile.Data)

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}

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

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)

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

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}

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

Returns: created_at (date-time), id (string), name (string), updated_at (date-time)

List notification settings

List notification settings.

GET /notification_settings

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

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 (arrayobject]), 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 (arrayobject]), status (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), updated_at (date-time)

go
	notificationSetting, err := client.NotificationSettings.New(context.Background(), telnyx.NotificationSettingNewParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", notificationSetting.Data)

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 (arrayobject]), 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}

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

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 (arrayobject]), 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}

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

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 (arrayobject]), status (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), updated_at (date-time)

Want to see if team-telnyx/telnyx-account-notifications-go would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/22/2026, 12:35 UTC · 22 cases

Lift

+68%

100% vs 32%

Agent turns

0%

1.0 vs 1.0

Tokens

+139%

4,602.91 vs 1,927.77

fail → pass · 15pass → pass · 7

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-03 Can you provide a Go example for Telnyx account notifications that fetches a specific notification setting by its unique ID? Show how to inspect the returned error to handle API-specific status codes appropriately if the call fails.	fail→pass	16,580	6,041	-64%	1	1	0%	3,435	4,902	+43%	0	0	—
case-04 I am building a web server in Go using the standard `net/http` package to process incoming webhook events from Telnyx. How should I verify the `Telnyx-Signature-ed25519` header using crypto/ed25519?	pass→pass	12,579	12,963	+3%	1	1	0%	3,297	6,320	+92%	0	0	—
case-01 I'm building an automated alert service using Telnyx in Go. Could you write a Go snippet that sets up a new notification profile named 'Production Webhooks' and then creates a webhook notification channel? Please include robust error handling that distinguishes network issues from API errors such as validation problems or rate limits.	fail→pass	16,904	9,266	-45%	1	1	0%	3,654	5,819	+59%	0	0	—
case-02 I need a Go program using the Telnyx SDK that retrieves all notification channels in my account. Since the list can span multiple pages, please use the library's automatic paging mechanism to iterate through all results and print each channel's destination and profile details.	fail→pass	11,199	6,081	-46%	1	1	0%	2,476	5,012	+102%	0	0	—
case-05 I need to send an outbound SMS message using the Telnyx Go SDK (`github.com/team-telnyx/telnyx-go`). Which client method and parameter struct are used to dispatch a text message?	fail→pass	9,098	5,221	-43%	1	1	0%	2,212	5,022	+127%	0	0	—
case-06 How do I configure the Telnyx Python SDK (`telnyx-python`) to update an account notification profile using Python's `telnyx.NotificationProfile.modify()` call?	pass→pass	6,994	4,607	-34%	1	1	0%	1,509	4,727	+213%	0	0	—
case-07 In Go, I want to construct a client for Telnyx using my API key stored in the environment variable `TELNYX_API_KEY`. Should I set a package-level global variable like `telnyx.APIKey = ...` or use a constructor?	pass→pass	9,146	2,627	-71%	1	1	0%	1,760	4,237	+141%	0	0	—
case-08 I want to delete an existing Telnyx notification profile with ID `182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e` in Go. What method call on the notification profiles service performs this deletion?	pass→pass	5,580	2,387	-57%	1	1	0%	1,214	4,251	+250%	0	0	—
case-09 When receiving an error from a Telnyx Go API call, I want to check if the request failed due to validation (HTTP 422) or rate limiting (HTTP 429). Which struct and field path hold the HTTP response status code?	pass→pass	7,828	3,014	-61%	1	1	0%	1,628	4,339	+167%	0	0	—
case-10 I am writing Go code to fetch all notification event conditions from my Telnyx account. Which method on the client should I invoke to list these event conditions?	fail→pass	5,122	1,929	-62%	1	1	0%	946	4,003	+323%	0	0	—
case-11 I need to list all available notification events in Telnyx using Go. What is the method name and parameter type to perform this GET request?	fail→pass	6,676	2,331	-65%	1	1	0%	1,361	4,156	+205%	0	0	—
case-12 Write a Go snippet to retrieve a single notification profile by its unique identifier string using the Telnyx client.	fail→pass	7,853	2,654	-66%	1	1	0%	1,664	4,249	+155%	0	0	—
case-13 I want to create a new Telnyx notification setting in Go. Which client service and parameter struct should I call?	fail→pass	6,270	2,710	-57%	1	1	0%	1,373	4,244	+209%	0	0	—
case-14 How do I remove/delete a specific Telnyx notification setting by ID in Go using the SDK?	pass→pass	9,078	3,173	-65%	1	1	0%	1,711	4,343	+154%	0	0	—
case-15 Write a Go function to update an existing notification profile's attributes on Telnyx using the official SDK.	fail→pass	7,347	7,704	+5%	1	1	0%	1,382	5,410	+291%	0	0	—
case-16 I am updating a notification channel in Telnyx using Go. What service method and parameter structure are expected by the SDK?	fail→pass	10,394	4,029	-61%	1	1	0%	2,020	4,569	+126%	0	0	—
case-17 Write a Go snippet that retrieves a single notification channel by its UUID from Telnyx.	fail→pass	10,700	3,734	-65%	1	1	0%	2,250	4,505	+100%	0	0	—
case-18 How do I delete a Telnyx notification channel using the Go SDK?	fail→pass	7,981	2,938	-63%	1	1	0%	1,577	4,215	+167%	0	0	—
case-19 I want to list all notification settings configured under my Telnyx account using Go. What client method and parameter struct do I pass?	fail→pass	7,605	2,774	-64%	1	1	0%	1,440	4,214	+193%	0	0	—
case-20 I need to list all notification profiles in my Telnyx account in Go. What method and param struct should I use?	fail→pass	7,924	2,624	-67%	1	1	0%	1,566	4,186	+167%	0	0	—
case-21 When configuring a new notification channel in Go using `client.NotificationChannels.New`, what struct fields are available for specifying channel destination and channel type?	fail→pass	8,647	4,610	-47%	1	1	0%	1,659	4,415	+166%	0	0	—
case-22 In Telnyx Go SDK error handling, if `errors.As(err, &apiErr)` is false when an API call returns an error, what category of error does that indicate and how should the application respond?	pass→pass	13,450	2,798	-79%	1	1	0%	2,277	4,126	+81%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +68 percentage points is the difference between those two pass rates over the 22 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 31.8%
Pass rate with the skill: 100%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/22/2026, 12:35 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-03

Prompt

Can you provide a Go example for Telnyx account notifications that fetches a specific notification setting by its unique ID? Show how to inspect the returned error to handle API-specific status codes appropriately if the call fails.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run100

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+141% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 6 days ago

Other measured skills in the registry, with their headline benchmark lift.