telnyx-email-inbound-curl

telnyx-email-inbound-curl is a skill for Claude Code, Codex from team-telnyx/ai. It costs 45 tokens per session (5,565 once invoked), scanned A, original, MIT.

A curl guide for using Telnyx's email service to manage incoming mailboxes, messages, threads, and sender filters.

In plain words
What is it for?
Use it to build email agents that read, search, reply to, or forward incoming messages from shell scripts or other tools that can run curl.
Why use it?
It explains how to make authenticated requests and handle errors such as invalid requests, authentication failures, service outages, and rate limits.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Part of the telnyx-email plugin — 4 skills shipped together

Good fit Use it to build email agents that read, search, reply to, or forward incoming messages from shell scripts or other tools that can run curl.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/team-telnyx/ai/telnyx-email-inbound-curl
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add team-telnyx/ai --skill telnyx-email-inbound-curl
Clone the repo
git clone --depth 1 https://github.com/team-telnyx/ai

Made for: Claude Code, Codex.

Or install telnyx-email, the plugin that ships this one along with the rest of its 4 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for telnyx-email-inbound-curl

README.md
[![agentmods](https://agentmods.dev/badge/skills/team-telnyx/ai/telnyx-email-inbound-curl/github.svg)](https://agentmods.dev/skills/team-telnyx/ai/telnyx-email-inbound-curl)
Your own site
<a href="https://agentmods.dev/skills/team-telnyx/ai/telnyx-email-inbound-curl"><img src="https://agentmods.dev/badge/skills/team-telnyx/ai/telnyx-email-inbound-curl/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for telnyx-email-inbound-curl

Your own site · 80×15
<a href="https://agentmods.dev/skills/team-telnyx/ai/telnyx-email-inbound-curl"><img src="https://agentmods.dev/badge/skills/team-telnyx/ai/telnyx-email-inbound-curl.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,565 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 8 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Tool Misuse · line 165
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • high Tool Misuse · line 462
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • high Tool Misuse · line 436
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • high Tool Misuse · line 475
    Tool parameters are crafted to achieve unintended or unsafe behavior. Parameter abuse can bypass intended safety checks (e.g. shell=True, --force, dangerous glob patterns).
    Fix: Validate all tool parameters against an allowlist. Reject dangerous parameter values (shell=True, --force, -rf /) and use safe defaults.
  • medium Data Exfiltration · line 27
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium Data Exfiltration · line 69
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium Data Exfiltration · line 110
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium Data Exfiltration · line 196
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00045 $0.05565
Opus 5 $0.00023 $0.02782
Sonnet 5 $0.00009 $0.01113
Haiku 4.5 $0.00005 $0.00556

Measured 12d ago against content hash 2ab670dbf257, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

telnyx-email-inbound-curl scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

name: telnyx-email-inbound-curl
providers/claude/plugins/telnyx-email/skills/telnyx-email-inbound-curl/SKILL.md · 519 lines

How it starts

The opening of the file, as written. The whole thing — 519 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Telnyx Email Inbound - curl

Installation

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

Setup

export TELNYX_API_KEY="YOUR_API_KEY_HERE"
export TELNYX_API_BASE="https://api.telnyx.com/v2"

All examples below use $TELNYX_API_KEY for authentication. Resource IDs are UUIDs; store the IDs returned by create and list calls rather than parsing them from email addresses.

Error Handling

All API calls can fail with network errors, authentication errors (401), validation errors (422), temporary service errors (503), or rate limits (429). Capture the HTTP status separately from the JSON response in production:

response_file="$(mktemp)"
status="$({ curl -sS \
  -o "$response_file" \
  -w '%{http_code}' \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  "$TELNYX_API_BASE/email_inboxes"; } || printf '000')"

if [[ "$status" != "200" ]]; then
  printf 'Telnyx request failed (HTTP %s)\n' "$status" >&2
  jq . "$response_file" >&2 2>/dev/null || true
fi
rm -f "$response_file"

Common status codes:

Status Meaning Action
400 Malformed request or send-time prerequisite failure Fix the request; do not retry unchanged.
401 Invalid or missing API key Replace the key and retry.
403 The account or inbox domain cannot send Correct permissions or sending-domain configuration.
404 Resource is missing, deleted, foreign, or the sending domain could not be resolved Re-list account-scoped resources; do not use the response to infer foreign resource existence.
422 Validation failed or every action recipient was suppressed Read .errors[] and fix the referenced field.
429 Rate limited or inbox-domain reputation suspended sending Honor retry guidance for rate limits; reputation suspension requires remediation.
503 Inbound storage, actions, or a dependency is unavailable Retry with bounded exponential backoff and jitter.

Read the full file on GitHub · 519 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 519 lines · 45 tokens per session scan A 2ab670dbf257

Subscribe to this mod's changes

telnyx-email-inbound-curl is a skill published in the GitHub repository team-telnyx/ai (214 stars, last pushed today), licensed MIT. It adds 45 tokens to every session and 5,565 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

shopify-cli

Use when scaffolding a new Shopify app, running Shopify CLI commands (shopify app dev/deploy/generate), configuring shopify.app.toml, generating app extensions (admin/checkout/theme/function), debugging tunnels or auth issues, or working with the official Remix/Node/PHP/Ruby app templates. Trigger on 'shopify app'…

khadinakbarlabs/shopify-app-builder · 140 tokens

shopify-mcp

Use this skill for shopify mcp. Triggers include: 'shopify mcp', 'shopify dev mcp', 'storefront mcp', 'merchant-facing mcp', 'well-known mcp', 'shopify mcp configuration', 'custom mcp shopify', 'agentic commerce', 'shopify agent', 'claude code shopify integration', 'mcp.json', 'shopify mcp setup'.

khadinakbarlabs/shopify-app-builder · 93 tokens

admin-graphql

Build Shopify Admin GraphQL queries and mutations for products, orders, customers, inventory, and more. Covers cost-aware rate limiting, cursor pagination, bulk operations, global resource identifiers, and version-safe API usage.

khadinakbarlabs/shopify-app-builder · 46 tokens

storefront-api

Build customer-facing storefront applications with Shopify Storefront API. Access product catalogs, collections, checkout flows, cart management, and customer accounts using public/private tokens. Includes GraphQL queries, Market directives, Customer Account API, and TypeScript examples. Triggers include: 'storefront…

khadinakbarlabs/shopify-app-builder · 95 tokens

webhooks

Webhook delivery methods, verification, retry behavior, payload handling, and implementation patterns for Shopify events. Triggers include: 'set up webhook', 'verify webhook signature', 'webhook delivery', 'HMAC verification', 'webhook retry', 'event subscription', 'webhook payload', 'AWS EventBridge Shopify', 'Google…

khadinakbarlabs/shopify-app-builder · 77 tokens

admin-rest

Use the legacy REST Admin API only when maintaining an existing integration. Covers common resources, the 40-request bucket with a 2-request-per-second standard restore rate, and migration to GraphQL. New public apps must use the GraphQL Admin API.

khadinakbarlabs/shopify-app-builder · 53 tokens