Ready to supercharge your AI agents?

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

Telnyx Messaging Profiles - Java · team-telnyx | DecimalAI

team-telnyx/telnyx-messaging-profiles-java

SkillScore96Maintained

Create and manage messaging profiles with number pools, sticky sender, and geomatch features. Configure short codes for high-volume messaging. 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-messaging-profiles-java/SKILL.md

decimalai skills pull team-telnyx-telnyx-messaging-profiles-java --out .claude/skills/

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

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

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

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

Yes — +74% lift · at higher cost+133% tokens0% turns96% of whole cases pass with skill (22/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	100%	0%
case-02	✗→✓	▲ Improved	138%	0%
case-03	✗→✓	▲ Improved	159%	0%
case-04	✗→✓	▲ Improved	323%	0%
case-05	✗→✓	▲ Improved	282%	0%

Showing 5 of 23 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-messaging-profiles-java/SKILL.md

View on GitHub ↗

License MITImported 8/27/2026Version v3

Skill contents

SKILL.md

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

GET /messaging_profiles

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListPage;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListParams;

MessagingProfileListPage page = client.messagingProfiles().list();

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 (arraystring])

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)

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileCreateParams;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileCreateResponse;

MessagingProfileCreateParams params = MessagingProfileCreateParams.builder()
    .name("My name")
    .addWhitelistedDestination("US")
    .build();
MessagingProfileCreateResponse messagingProfile = client.messagingProfiles().create(params);

Retrieve a messaging profile

GET /messaging_profiles/{id}

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileRetrieveParams;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileRetrieveResponse;

MessagingProfileRetrieveResponse messagingProfile = client.messagingProfiles().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

Update a messaging profile

PATCH /messaging_profiles/{id}

Optional: ai_assistant_id (string | null), 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 (arraystring])

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileUpdateParams;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileUpdateResponse;

MessagingProfileUpdateResponse messagingProfile = client.messagingProfiles().update("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

Delete a messaging profile

DELETE /messaging_profiles/{id}

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileDeleteParams;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileDeleteResponse;

MessagingProfileDeleteResponse messagingProfile = client.messagingProfiles().delete("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

List phone numbers associated with a messaging profile

GET /messaging_profiles/{id}/phone_numbers

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListPhoneNumbersPage;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListPhoneNumbersParams;

MessagingProfileListPhoneNumbersPage page = client.messagingProfiles().listPhoneNumbers("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

Returns: country_code (string), created_at (date-time), eligible_messaging_products (arraystring]), 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 (arraystring]), 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

java
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListShortCodesPage;
import com.telnyx.sdk.models.messagingprofiles.MessagingProfileListShortCodesParams;

MessagingProfileListShortCodesPage page = client.messagingProfiles().listShortCodes("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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

java
import com.telnyx.sdk.models.shortcodes.ShortCodeListPage;
import com.telnyx.sdk.models.shortcodes.ShortCodeListParams;

ShortCodeListPage page = client.shortCodes().list();

Retrieve a short code

GET /short_codes/{id}

java
import com.telnyx.sdk.models.shortcodes.ShortCodeRetrieveParams;
import com.telnyx.sdk.models.shortcodes.ShortCodeRetrieveResponse;

ShortCodeRetrieveResponse shortCode = client.shortCodes().retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e");

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)

java
import com.telnyx.sdk.models.shortcodes.ShortCodeUpdateParams;
import com.telnyx.sdk.models.shortcodes.ShortCodeUpdateResponse;

ShortCodeUpdateParams params = ShortCodeUpdateParams.builder()
    .id("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
    .messagingProfileId("abc85f64-5717-4562-b3fc-2c9600000000")
    .build();
ShortCodeUpdateResponse shortCode = client.shortCodes().update(params);

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

Latest benchmark · publisher runVerified

8/27/2026, 07:09 UTC · 23 cases

Lift

+74%

96% vs 22%

Agent turns

1.0 vs 1.0

Tokens

+133%

5,070.09 vs 2,176.35

fail → pass · 17pass → pass · 5fail → fail · 1

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I am building a Java backend service that interacts with Telnyx for SMS profile management. Could you provide a snippet that creates a new messaging profile named 'Notifications' configured for US destinations? Please include robust error handling for API failures such as rate limiting (429) or validation issues (422), using the official Java client initialized from environment variables.	fail→pass	13,359	8,988	-33%	1	1	0%	3,020	6,041	+100%	0	0	—
case-02 Can you show me how to write a Java method using the Telnyx SDK that fetches all messaging profiles and lists all phone numbers linked to each profile? I need it to handle pagination automatically so I can process every item across multiple pages seamlessly without manually tracking page tokens.	fail→pass	13,166	10,060	-24%	1	1	0%	2,610	6,215	+138%	0	0	—
case-03 I need a Java code example using Telnyx's SDK to update a short code resource. Specifically, I want to disassociate the short code from its existing profile and assign a list of tags like 'marketing' and 'promo'. How do I invoke the update operation with the official SDK?	fail→pass	11,008	9,286	-16%	1	1	0%	2,359	6,103	+159%	0	0	—
case-04 I am setting up a Maven pom.xml file for a Java project that needs to integrate with Telnyx SMS messaging profiles. What is the standard Maven dependency XML snippet for the official SDK?	fail→pass	5,037	1,487	-70%	1	1	0%	1,002	4,234	+323%	0	0	—
case-05 We are migrating our build scripts to Gradle and need to add the official Telnyx Java SDK artifact. What dependency line should we place in build.gradle?	fail→pass	5,493	1,489	-73%	1	1	0%	1,094	4,178	+282%	0	0	—
case-06 In Java, how do I initialize the primary Telnyx SDK client from environment variables using the standard OkHttp client builder?	fail→pass	13,673	2,041	-85%	1	1	0%	2,649	4,303	+62%	0	0	—
case-07 I have a messaging profile ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'. How do I call the Telnyx Java client to fetch the details for this specific profile?	fail→pass	10,404	8,561	-18%	1	1	0%	2,361	4,691	+99%	0	0	—
case-08 Show me the Telnyx Java SDK call required to permanently remove a messaging profile with ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'.	fail→pass	7,962	4,362	-45%	1	1	0%	1,692	4,870	+188%	0	0	—
case-09 How do I update an existing messaging profile using the Telnyx Java SDK client? Provide the basic invocation pattern for updating profile settings by ID.	fail→pass	11,286	8,209	-27%	1	1	0%	2,335	5,579	+139%	0	0	—
case-10 I want to inspect all short codes assigned to a specific messaging profile ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'. What client method in the Telnyx Java SDK performs this query?	fail→pass	11,541	3,871	-66%	1	1	0%	2,268	4,537	+100%	0	0	—
case-11 How do I query all short codes across my entire Telnyx account using the Java SDK client, without scoping to a single messaging profile?	fail→pass	13,906	5,363	-61%	1	1	0%	2,283	4,696	+106%	0	0	—
case-20 How do I send an outbound SMS message to '+18005550199' with body 'Hello World' using the Telnyx Java SDK?	fail→fail	11,177	8,909	-20%	1	1	0%	1,828	5,964	+226%	0	0	—
case-12 Given a short code resource ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', how do I retrieve its metadata using the Telnyx Java SDK?	fail→pass	9,485	3,750	-60%	1	1	0%	1,973	4,740	+140%	0	0	—
case-13 In our Java application, we prefer manual pagination over automatic streaming iteration when listing messaging profiles. Which methods on the list page response allow checking for and fetching subsequent pages?	fail→pass	9,932	2,797	-72%	1	1	0%	1,775	4,476	+152%	0	0	—
case-14 When calling Telnyx messaging profile methods in Java, what specific exception class is thrown by the SDK on API failures, and what method provides the HTTP status code?	fail→pass	38,964	2,628	-93%	1	1	0%	1,651	4,425	+168%	0	0	—
case-15 I need to build a MessagingProfileCreateParams instance in Java to create a messaging profile. What are the mandatory builder calls required before building?	pass→pass	15,877	2,358	-85%	1	1	0%	1,162	4,356	+275%	0	0	—
case-21 I am setting up a Spring Boot HTTP endpoint in Java to receive Telnyx webhook notifications. How do I verify the event signature header sent by Telnyx in Java?	pass→pass	32,114	24,968	-22%	1	1	0%	3,435	8,295	+141%	0	0	—
case-16 When invoking client.messagingProfiles().listPhoneNumbers(...), what is the class type returned by the SDK call representing the list page?	pass→pass	13,350	1,853	-86%	1	1	0%	2,415	4,291	+78%	0	0	—
case-17 When calling client.shortCodes().update(...) in the Java SDK, how are parameters supplied to the update method?	fail→pass	17,660	4,386	-75%	1	1	0%	3,047	4,852	+59%	0	0	—
case-18 What is the return type of client.shortCodes().list() in the Telnyx Java SDK?	fail→pass	9,599	1,621	-83%	1	1	0%	1,794	4,191	+134%	0	0	—
case-19 What class represents the return response when creating a messaging profile via client.messagingProfiles().create(params)?	fail→pass	11,223	2,661	-76%	1	1	0%	1,643	4,306	+162%	0	0	—
case-22 In my Java application, I want to search and purchase or order a new phone number using the Telnyx API. How do I query available phone numbers via the Telnyx Java client?	pass→pass	14,690	13,482	-8%	1	1	0%	3,263	6,254	+92%	0	0	—
case-23 In Java, when an API operation throws a TelnyxServiceException with HTTP status code 429, what is the recommended retry handling pattern?	pass→pass	42,700	4,946	-88%	1	1	0%	2,397	5,015	+109%	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. 23 cases were attempted. The headline lift of +74 percentage points is the difference between those two pass rates over the 23 comparable cases.

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

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

Prompt

I am building a Java backend service that interacts with Telnyx for SMS profile management. Could you provide a snippet that creates a new messaging profile named 'Notifications' configured for US destinations? Please include robust error handling for API failures such as rate limiting (429) or validation issues (422), using the official Java client initialized from environment variables.

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 run96

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+133% 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 2 days ago

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

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