Skip to content
TakoAPI
Back to skills

telnyx-freemium-upgrade

by teamtelnyx

Communication
400Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Automatically upgrade Telnyx account from freemium to professional tier.

Description

What This Skill Does

Upgrades a Telnyx account from freemium to professional tier by verifying identity through GitHub or LinkedIn OAuth. Handles API key resolution, token scope checks, evaluation submission, and result polling automatically. Triggered by freemium API error codes or explicit user requests.

Handles the entire upgrade flow, including GitHub token scope negotiation, device authorization, and evaluation polling, without requiring the user to visit the Telnyx portal.

When to Use It

  • Unblocking SMS to unverified destinations after error code 10039
  • Removing the one-number purchase limit before buying multiple phone numbers
  • Enabling number porting from a carrier blocked by freemium restrictions
  • Unlocking managed account creation for sub-accounts
  • Pre-upgrading before a voice call fails with a destination-not-verified error

Example Workflow

INPUT

User asks: Send an SMS to +1-555-123-4567

AGENT
  1. 1

    Detect freemium restriction (error 10039) on SMS send attempt

  2. 2

    Check ~/.telnyx/upgrade.json cache for prior evaluation results

  3. 3

    Run check-gh-auth.sh to verify GitHub token type and scopes

  4. 4

    Run evaluate-upgrade.py --github-token <TOKEN> --api-key <KEY> to submit the upgrade evaluation

  5. 5

    Poll for APPROVED result, then retry the original SMS send

OUTPUT

SMS delivered to +1-555-123-4567 after account upgraded to professional tier

Requirements

  • TELNYX_API_KEY environment variable or ~/.config/telnyx/config.json
  • GitHub CLI (gh) installed and authenticated with a personal GitHub account
  • GitHub account or LinkedIn account for identity verification

Installation

clawhub install teamtelnyx/telnyx-freemium-upgrade

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links