sinch-api-senders-list

Generates TypeScript code for listing virtual phone numbers via the Sinch Numbers API.

6|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-senders-list-sinch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-api-senders-list
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-senders-list
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-senders-list-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @sinch/sdk-core.

What problem does it solve? Developers integrating the Sinch Numbers API often need working code examples for listing active virtual phone numbers with filters and pagination, but writing this from scratch requires reading API documentation and handling OAuth2 authentication manually. ## Core Features & Use Cases - Interactive Code Generation: Presents a menu to filter numbers by region code, type (MOBILE, LOCAL, TOLL_FREE), or capability (SMS, VOICE), then generates matching TypeScript snippets. - Configuration Detection: Retrieves Sinch credentials from the Sinch MCP server or falls back to environment variables (CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET). - Optional Live Execution: Calls the Numbers API endpoint GET /v1/projects/{projectId}/activeNumbers with OAuth2 and displays results in a formatted table. - Use Case: A developer building a messaging app needs to see which SMS-capable US numbers are active in their Sinch project; this Skill generates the ready-to-use SDK code and can run the query directly. ## Quick Start Ask the assistant to list your active Sinch phone numbers or generate Numbers API code for filtering numbers by region and capability.

Frequently Asked Questions about sinch-api-senders-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list active phone numbers with the Sinch Numbers API?

Send a GET request to https://numbers.api.sinch.com/v1/projects/{projectId}/activeNumbers using OAuth2 authentication with your key ID and secret. This Skill generates the TypeScript code for that request, including filters and pagination handling.

How to filter Sinch numbers by region or capability?

The Numbers API accepts query filters for regionCode, type (MOBILE, LOCAL, TOLL_FREE), and capabilities such as SMS or VOICE. The interactive menu in this Skill lets you pick a filter and produces the corresponding SDK code.

What credentials does the Sinch Numbers API require?

You need a Sinch Project ID, Access Key ID, and Access Key Secret from the Sinch Customer Dashboard. The Skill reads these from the Sinch MCP configuration or from CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, and CONVERSATION_KEY_SECRET environment variables.

Why does the Sinch API report it is not configured?

This happens when neither the Sinch MCP server nor the required environment variables are available. Set CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, and CONVERSATION_KEY_SECRET, or configure the Sinch Build MCP server, then retry.

Can I execute the generated Sinch Numbers API code directly?

Yes, on request the Skill can call the activeNumbers endpoint directly using your configured credentials and display the results in a formatted table. Otherwise it outputs TypeScript code you can run in your own Node.js project.