Messages

Bulk send

The same text to up to 1,000 recipients per request. Each recipient gets their own message, with its own ID and events.

POST/v1/messages/bulk-sendx-api-key · all or nothing

Request

tostring[]required

List of 1 to 1,000 numbers in international format.

contentstringrequired

Message text, up to 1,024 characters.

fromstringrequired

Sending number. Automatic selection from the fleet is coming soon for bulk sends. Ignored in the sandbox.

request_idstring

Identifier shared by all messages in the batch. If you send the batch again with the same request_id, recipients already reached within 24 h get their first message back, with no new send or charge.

curl -X POST https://api.getsms.tech/v1/messages/bulk-send \
  -H "x-api-key: $GETSMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "+212661234501",
       "to": ["+212612345678", "+212623456789"],
       "content": "Our sale starts tomorrow at 9 am."}'

await fetch("https://api.getsms.tech/v1/messages/bulk-send", {
  method: "POST",
  headers: { "x-api-key": process.env.GETSMS_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "+212661234501",
    to: ["+212612345678", "+212623456789"],
    content: "Our sale starts tomorrow at 9 am.",
  }),
});

requests.post(
    "https://api.getsms.tech/v1/messages/bulk-send",
    headers={"x-api-key": os.environ["GETSMS_API_KEY"]},
    json={"from": "+212661234501", "to": ["+212612345678", "+212623456789"],
          "content": "Our sale starts tomorrow at 9 am."},
)

<?php
$payload = ["from" => "+212661234501", "to" => ["+212612345678", "+212623456789"],
            "content" => "Our sale starts tomorrow at 9 am."];
// same call as for a single SMS, on /v1/messages/bulk-send