BulkGate icon

BulkGate

Interact with the BulkGate API

Advanced → Promotional SMS

AI-generated

Summary

Send a promotional SMS message to multiple recipient phone numbers using specified parameters such as message text, country code, sender ID, and optional scheduling.

Inputs

  • Number (required) — One or more recipient phone numbers in international format, provided as a collection of phone number strings.
  • Text (required) — The text content of the SMS message, supporting up to 612 characters for 7-bit encoding or 268 for Unicode; encoded in UTF-8.
  • Country — ISO 3166-1 alpha-2 country code to specify the country or provide the country code when local phone number parts are given.
  • Sender ID — A selection of predefined sender ID types such as gMobile, gOwn, gProfile, etc., to define the sender identity.
  • Sender ID Value — The value associated with the selected sender ID type, e.g., phone number or text identifier.
  • Unicode — Option to specify whether the SMS message is sent using Unicode encoding ('yes') or standard 7-bit encoding ('no').
  • Schedule — Optional scheduling of message sending time using a Unix timestamp or ISO 8601 date-time string.
  • Duplicates Check — When enabled ('On'), prevents sending duplicate messages with the same text to the same number within a 5-minute interval; defaults to 'Off'.

Output shape

A list of message sending results, each corresponding to an input phone number, including status and message identifiers.

If duplicates check is enabled, potential duplicate messages within five minutes are removed before sending. Scheduled messages are queued for future sending at the specified time.

Links

Discussion