Ready to supercharge your AI agents?

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

Get Started Free →

Telnyx Account Notifications - Java · team-telnyx | DecimalAI

team-telnyx/telnyx-account-notifications-java

SkillScore100Maintained

Configure notification channels and settings for account alerts and events. This skill provides Java 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-java/SKILL.md

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

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

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

Raw file: /s/team-telnyx-telnyx-account-notifications-java/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-account-notifications-java.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

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

Yes — +79% lift · at higher cost+124% tokens0% turns96% of whole cases pass with skill (23/24)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	94%	0%
case-02	✗→✓	▲ Improved	104%	0%
case-03	✗→✓	▲ Improved	89%	0%
case-04	✗→✓	▲ Improved	331%	0%
case-05	✗→✓	▲ Improved	217%	0%

Showing 5 of 24 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/27/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-java/SKILL.md

View on GitHub ↗

License MITImported 8/27/2026Version v3

Skill contents

SKILL.md

Telnyx Account Notifications - Java

Installation

text
<!-- Maven -->
<dependency>
    <groupId>com.telnyx.sdk</groupId>
    <artifactId>telnyx</artifactId>
    <version>6.89.0</version>
</dependency>

// Gradle
implementation("com.telnyx.sdk:telnyx:6.89.0")

Setup

java
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

TelnyxClient client = TelnyxOkHttpClient.fromEnv();

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:

java
import com.telnyx.sdk.errors.TelnyxServiceException;

try {
    var result = client.messages().send(params);
} catch (TelnyxServiceException e) {
    System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
    if (e.statusCode() == 422) {
        System.err.println("Validation error — check required fields and formats");
    } else if (e.statusCode() == 429) {
        // Rate limited — wait and retry with exponential backoff
        Thread.sleep(1000);
    }
}

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: List methods return a page. Use .autoPager() for automatic iteration: for (var item : page.autoPager()) { ... }. For manual control, use .hasNextPage() and .nextPage().

List notification channels

List notification channels.

GET /notification_channels

java
import com.telnyx.sdk.models.notificationchannels.NotificationChannelListPage;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelListParams;

NotificationChannelListPage page = client.notificationChannels().list();

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)

java
import com.telnyx.sdk.models.notificationchannels.NotificationChannelCreateParams;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelCreateResponse;

NotificationChannelCreateParams params = NotificationChannelCreateParams.builder()

    .channelTypeId("550e8400-e29b-41d4-a716-446655440000")

    .channelDestination("https://example.com/webhooks")

    .build();

NotificationChannelCreateResponse notificationChannel = client.notificationChannels().create(params);

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}

java
import com.telnyx.sdk.models.notificationchannels.NotificationChannelRetrieveParams;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelRetrieveResponse;

NotificationChannelRetrieveResponse notificationChannel = client.notificationChannels().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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)

java
import com.telnyx.sdk.models.notificationchannels.NotificationChannel;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelUpdateParams;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelUpdateResponse;

NotificationChannelUpdateParams params = NotificationChannelUpdateParams.builder()
    .notificationChannelId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
    .notificationChannel(NotificationChannel.builder().build())
    .build();
NotificationChannelUpdateResponse notificationChannel = client.notificationChannels().update(params);

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}

java
import com.telnyx.sdk.models.notificationchannels.NotificationChannelDeleteParams;
import com.telnyx.sdk.models.notificationchannels.NotificationChannelDeleteResponse;

NotificationChannelDeleteResponse notificationChannel = client.notificationChannels().delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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

java
import com.telnyx.sdk.models.notificationeventconditions.NotificationEventConditionListPage;
import com.telnyx.sdk.models.notificationeventconditions.NotificationEventConditionListParams;

NotificationEventConditionListPage page = client.notificationEventConditions().list();

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

java
import com.telnyx.sdk.models.notificationevents.NotificationEventListPage;
import com.telnyx.sdk.models.notificationevents.NotificationEventListParams;

NotificationEventListPage page = client.notificationEvents().list();

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

java
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileListPage;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileListParams;

NotificationProfileListPage page = client.notificationProfiles().list();

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)

java
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileCreateParams;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileCreateResponse;

NotificationProfileCreateParams params = NotificationProfileCreateParams.builder()

    .name("My Notification Profile")

    .build();

NotificationProfileCreateResponse notificationProfile = client.notificationProfiles().create(params);

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}

java
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileRetrieveParams;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileRetrieveResponse;

NotificationProfileRetrieveResponse notificationProfile = client.notificationProfiles().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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)

java
import com.telnyx.sdk.models.notificationprofiles.NotificationProfile;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileUpdateParams;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileUpdateResponse;

NotificationProfileUpdateParams params = NotificationProfileUpdateParams.builder()
    .notificationProfileId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
    .notificationProfile(NotificationProfile.builder().build())
    .build();
NotificationProfileUpdateResponse notificationProfile = client.notificationProfiles().update(params);

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}

java
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileDeleteParams;
import com.telnyx.sdk.models.notificationprofiles.NotificationProfileDeleteResponse;

NotificationProfileDeleteResponse notificationProfile = client.notificationProfiles().delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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

List notification settings

List notification settings.

GET /notification_settings

java
import com.telnyx.sdk.models.notificationsettings.NotificationSettingListPage;
import com.telnyx.sdk.models.notificationsettings.NotificationSettingListParams;

NotificationSettingListPage page = client.notificationSettings().list();

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)

java
import com.telnyx.sdk.models.notificationsettings.NotificationSettingCreateParams;
import com.telnyx.sdk.models.notificationsettings.NotificationSettingCreateResponse;

NotificationSettingCreateResponse notificationSetting = client.notificationSettings().create();

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}

java
import com.telnyx.sdk.models.notificationsettings.NotificationSettingRetrieveParams;
import com.telnyx.sdk.models.notificationsettings.NotificationSettingRetrieveResponse;

NotificationSettingRetrieveResponse notificationSetting = client.notificationSettings().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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}

java
import com.telnyx.sdk.models.notificationsettings.NotificationSettingDeleteParams;
import com.telnyx.sdk.models.notificationsettings.NotificationSettingDeleteResponse;

NotificationSettingDeleteResponse notificationSetting = client.notificationSettings().delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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-java would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/27/2026, 18:48 UTC · 24 cases

Lift

+79%

96% vs 17%

Agent turns

0%

1.0 vs 1.0

Tokens

+124%

4,754 vs 2,126.25

fail → pass · 19pass → pass · 4fail → fail · 1

Per-case results (24)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 Can you show me a Java snippet using the Telnyx SDK to create a new webhook notification channel? I need to specify the endpoint destination URL and channel type ID, while making sure to handle potential rate limits or validation errors gracefully.	fail→pass	17,175	7,273	-58%	1	1	0%	2,749	5,323	+94%	0	0	—
case-02 I need a Java example for the Telnyx Java SDK that creates a notification profile, lists all active notification event conditions, and iterates over all notification settings using auto-pagination.	fail→pass	19,854	10,981	-45%	1	1	0%	2,981	6,081	+104%	0	0	—
case-03 How do I use the Telnyx Java SDK to fetch a specific notification setting by ID, update an existing notification channel, and delete an outdated notification profile?	fail→pass	20,202	10,794	-47%	1	1	0%	3,103	5,872	+89%	0	0	—
case-04 I am adding the official Telnyx Java library to my Maven pom.xml file. What dependency entry should I add for the SDK?	fail→pass	6,424	1,558	-76%	1	1	0%	919	3,962	+331%	0	0	—
case-05 I'm setting up a Gradle build file for a Java service that integrates Telnyx notifications. How do I declare the implementation dependency for the Telnyx Java SDK?	fail→pass	8,715	2,251	-74%	1	1	0%	1,295	4,106	+217%	0	0	—
case-06 What Java code initializes the standard Telnyx client from environment variables using the default HTTP client engine?	pass→pass	9,403	2,166	-77%	1	1	0%	1,754	4,014	+129%	0	0	—
case-07 When invoking Telnyx account notification endpoints in Java, what SDK exception class should be caught to handle HTTP errors, rate limiting, or validation failures?	fail→pass	10,090	3,939	-61%	1	1	0%	1,456	4,378	+201%	0	0	—
case-08 In a Java try-catch block catching a Telnyx service exception, how do you specifically check if the failure was caused by a rate limit response?	fail→pass	9,101	4,620	-49%	1	1	0%	1,643	4,396	+168%	0	0	—
case-09 I am listing notification channels using the Telnyx Java SDK and want to loop through all pages automatically without manually tracking page tokens. How is this achieved in Java?	fail→pass	13,386	4,963	-63%	1	1	0%	2,250	4,518	+101%	0	0	—
case-10 When handling paginated results from a Telnyx Java SDK list call manually without autoPager, what methods on the page object are used to check for and fetch the next page?	fail→pass	13,150	2,631	-80%	1	1	0%	1,731	4,180	+141%	0	0	—
case-11 Show the Java code call using TelnyxClient to fetch the list of configured notification channels on the account.	fail→pass	21,274	4,489	-79%	1	1	0%	2,177	4,312	+98%	0	0	—
case-12 How do you retrieve details for a single notification channel with ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' using the Telnyx Java SDK?	fail→pass	11,023	5,015	-55%	1	1	0%	1,794	4,551	+154%	0	0	—
case-13 Write a Java call using the Telnyx SDK to delete a notification channel by its ID.	fail→pass	8,143	6,216	-24%	1	1	0%	1,502	4,682	+212%	0	0	—
case-14 Which SDK client method is used in Java to fetch all notification event conditions?	fail→pass	20,083	2,058	-90%	1	1	0%	3,246	4,051	+25%	0	0	—
case-15 How do you query all notification events available on the account using the Telnyx Java client?	fail→pass	10,726	3,520	-67%	1	1	0%	1,991	4,384	+120%	0	0	—
case-16 Provide the Java code snippet to retrieve all notification profiles using the initialized Telnyx client.	fail→pass	10,583	2,610	-75%	1	1	0%	2,011	4,119	+105%	0	0	—
case-17 How do you build parameters and execute a call to create a new notification profile named 'My Notification Profile' using the Telnyx Java SDK?	fail→pass	13,540	5,529	-59%	1	1	0%	2,125	4,541	+114%	0	0	—
case-18 In the Telnyx Java SDK, what parameter builder class and client method are used to update an existing notification profile?	pass→pass	10,634	3,423	-68%	1	1	0%	1,941	4,387	+126%	0	0	—
case-19 Write a Java snippet to list all notification settings via the Telnyx client.	fail→pass	12,722	4,450	-65%	1	1	0%	1,943	4,574	+135%	0	0	—
case-20 What is the client method call to add a new notification setting using default or empty creation parameters in the Telnyx Java SDK?	pass→pass	6,923	2,686	-61%	1	1	0%	1,248	4,162	+233%	0	0	—
case-21 How do you delete a notification setting by ID using the Telnyx Java SDK client?	fail→pass	10,022	3,608	-64%	1	1	0%	1,980	4,372	+121%	0	0	—
case-22 I am building a Java application to issue an outbound phone call and handle call control commands like answering and hanging up via Telnyx. Does the Telnyx account notifications Java package provide the call control methods for creating and bridging calls?	fail→pass	11,014	8,033	-27%	1	1	0%	2,046	5,227	+155%	0	0	—
case-23 How do I construct a webhook event receiver in Java to verify the Telnyx-Signature header on incoming HTTP POST payloads using public key cryptographic verification?	fail→fail	38,418	22,227	-42%	1	1	0%	4,502	8,089	+80%	0	0	—
case-24 Show me how to send an SMS text message to a destination phone number using the notification channels endpoints in the Telnyx Java SDK.	pass→pass	14,227	10,670	-25%	1	1	0%	2,643	5,815	+120%	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. 24 cases were attempted. The headline lift of +79 percentage points is the difference between those two pass rates over the 24 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 16.7%
Pass rate with the skill: 95.8%
Cases attempted: 24
Cases counted toward lift: 24
Cases that regressed: 0
Skill version measured: v3
Run completed: 8/27/2026, 18:48 UTC

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

Prompt

Can you show me a Java snippet using the Telnyx SDK to create a new webhook notification channel? I need to specify the endpoint destination URL and channel type ID, while making sure to handle potential rate limits or validation errors gracefully.

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+127% 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 yesterday

Model	Method	Date	Lift
gemini-3.6-flash	verified	8/22/2026	+83%

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