telnyx-freemium-upgrade
by teamtelnyx
CommunicationBrief
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
User asks: Send an SMS to +1-555-123-4567
- 1
Detect freemium restriction (error 10039) on SMS send attempt
- 2
Check ~/.telnyx/upgrade.json cache for prior evaluation results
- 3
Run check-gh-auth.sh to verify GitHub token type and scopes
- 4
Run evaluate-upgrade.py --github-token <TOKEN> --api-key <KEY> to submit the upgrade evaluation
- 5
Poll for APPROVED result, then retry the original SMS send
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-upgradeRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.