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.