sinch-api-batch-send

Send one message to up to 1000 recipients via the Sinch Conversation Batch API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Sending the same SMS or RCS message to many recipients one at a time is slow and error-prone. This Skill submits a single batch request to the Sinch Conversation Batch API, delivering one message definition to up to 1000 recipients with optional per-recipient personalization. ## Core Features & Use Cases - Batch Messaging: Send one message to up to 1000 E.164 recipients in a single API call. - Per-Recipient Personalization: Use ${variable} placeholders in the message text and supply per-recipient parameter values for substitution. - Multi-Channel Support: Choose the delivery channel (SMS, RCS, etc.) with SMS as the default. - Use Case: A support team needs to notify 500 customers of an outage with individualized names and ticket codes. Provide the message template, recipient list, and a parameters JSON, and the batch is submitted in one request. ## Quick Start Ask the assistant to send a batch SMS such as "Hello ${name}, your code is ${code}" to a comma-separated list of E.164 numbers with a parameters JSON mapping each recipient to their values.

Frequently Asked Questions about sinch-api-batch-send

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

FAQPage Schema
How do I send bulk SMS messages with the Sinch Batch API?▼

Provide a message text, a comma-separated list of E.164 recipient numbers (or a file with one number per line), and optionally a channel. The Skill posts one request to the Sinch Conversation Batch API with the message and a recipient_and_params array.

How do I personalize batch messages for each recipient?▼

Include ${variable} placeholders in the message text and pass a JSON object mapping each recipient index to a parameters object. Each recipient's parameters are substituted into the template before delivery.

What is the maximum number of recipients per Sinch batch request?▼

The Sinch Conversation Batch API accepts up to 1000 recipients per request. Larger audiences must be split into multiple batch submissions.

What credentials does the Sinch Batch API require?▼

It requires five environment variables: CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET, CONVERSATION_REGION (us, eu, or br), and CONVERSATION_APP_ID. If any are missing, the Skill reports that the Sinch API is not configured.

Why does my Sinch batch request return a 400 or 401 error?▼

A 400 error usually means a malformed body, such as using a messages array instead of one message plus recipient_and_params. A 401 indicates invalid or missing OAuth2 credentials derived from your key ID and secret.