Specifying add-batch channel

To specify channels with the add-batch endpoint, you specify a single channel to send, and an array of channels to fall back through.

Making the request

add-batch accepts two parameters in the request body: channel, and fallback_channels.

• channel is expected to be a string. The string must be a valid accepted channel value.
• fallback_channels is expected to be an array of strings. Each string must be a valid accepted channel value.

In this example, we're aiming to send a message to the rcs channel. If it fails to deliver via RCS, it will fall back to sending via the sms channel.

---

POST https://mplus.instagiv.com/batch

{
    "from": "mplus-test",
    "message": "Bulk test message",
    "destinations": ["441111111111", "442222222222", "443333333333"],
    "channel": "rcs",
    "fallback_channels": ["sms"]
}

---

response body

{
  "identifier": "0d064d2c-fafb-4363-b863-28fe49ebe67f"
}

Accepted channels

Currently, we accept two channels to the add-batch endpoint

value	Channel
sms	SMS
rcs	RCS