Download OpenAPI specification:Download
Batches are sets of SMS messages. You can send a single message or many. Batches are queued and sent at the rate limit in first-in-first-out order.
Send a message or a batch of messages.
Depending on the length of the body, one message might be split into multiple parts and charged accordingly.
Any groups targeted in a scheduled batch will be evaluated at the time of sending. If a group is deleted between batch creation and scheduled date, it will be considered empty.
Be sure to use the correct region in the server URL.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
Default schema is Text if type is not specified.
body required | string [ 0 .. 2000 ] characters The message content | ||||||||||
to required | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
type | string Regular SMS
| ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be a valid URL. Learn how to set a default callback URL here. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
Created. A successful response, or an Error.
type required | string Regular SMS | ||||||||||
id | string Unique identifier for batch | ||||||||||
to | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
canceled | boolean Default: false Indicates if the batch has been canceled or not. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
created_at | string <date-time> Timestamp for when batch was created. Formatted as ISO-8601: | ||||||||||
modified_at | string <date-time> Timestamp for when batch was last updated. Formatted as ISO-8601: | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
{- "from": "YOUR_Sinch_virtual_number",
- "to": [
- "YOUR_recipient_number"
], - "body": "YOUR_message_body",
- "delivery_report": "summary",
- "type": "mt_text"
}
{- "id": "01FC66621XXXXX119Z8PMV1QPQ",
- "to": [
- 15551231234,
- 15551256344
], - "from": 15551231234,
- "canceled": false,
- "parameters": {
- "{parameter_key}": {
- "{msisdn}": 15551231234,
- "default": "string"
}
}, - "body": "Hi ${name}! How are you?",
- "type": "mt_text",
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "delivery_report": "none",
- "send_at": "2019-08-24T14:15:22Z",
- "expire_at": "2019-08-24T14:15:22Z",
- "callback_url": "myCallbackUrl",
- "client_reference": "myReference",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": true,
- "max_number_of_message_parts": 1,
- "from_ton": 6,
- "from_npi": 18
}
With the list operation you can list batch messages created in the last 14 days that you have created. This operation supports pagination.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
page | integer >= 0 Default: 0 The page number starting from 0. Example: page=2 |
page_size | integer <= 100 Default: 30 Determines the size of a page. Example: page_size=50 |
from | string Only list messages sent from this sender number. Multiple originating numbers can be comma separated. Must be phone numbers or short code. Example: from=44345,45607 |
start_date | string <date-time> Only list messages received at or after this date/time. Formatted as ISO-8601: Default: Now-24 |
end_date | string <date-time> Only list messages received before this date/time. Formatted as ISO-8601: |
client_reference | string [ 0 .. 2048 ] characters Client reference to include Example: client_reference=myReference |
OK. A successful response, or an Error.
{- "count": "2",
- "page": "1",
- "batches": [
- {
- "id": "abc123",
- "to": [
- "01234567"
], - "from": "01234567",
- "canceled": false,
- "body": "Test message",
- "udh": "abcxaf123",
- "type": "mt_text",
- "created_at": "2023-11-11T09:00:20.0",
- "modified_at": "2023-11-11T09:00:20.0",
- "delivery_report": "none",
- "send_at": "2023-11-11T09:00:20.0",
- "expire_at": "",
- "callback_url": "",
- "client_reference": "xyz",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": "false",
- "max_number_of_message_parts": "1",
- "from_ton": "0",
- "from_npi": "0"
}, - {
- "id": "def345",
- "to": [
- "07654321"
], - "from": "012346790",
- "canceled": false,
- "body": "Test Message 2",
- "udh": "abcxaf123",
- "type": "mt_text",
- "created_at": "2023-11-11T09:00:20.0",
- "modified_at": "2023-11-11T09:00:20.0",
- "delivery_report": "none",
- "send_at": "2023-11-11T09:00:20.0",
- "expire_at": "2023-11-11T09:00:20.0",
- "callback_url": "",
- "client_reference": "abc",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": "false",
- "max_number_of_message_parts": "1",
- "from_ton": "0",
- "from_npi": "0"
}
], - "page_size": "10"
}
This operation will perform a dry run of a batch which calculates the bodies and number of parts for all messages in the batch without actually sending any messages.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
body required | string [ 0 .. 2000 ] characters The message content | ||||||||||
to required | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
type | string Regular SMS
| ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be a valid URL. Learn how to set a default callback URL here. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
OK. A successful response , or an Error.
{- "from": "YOUR_virtual_number",
- "to": [
- "YOUR_numbers_sending_to",
- "another_number"
], - "body": "YOUR body text here",
- "parameters": {
- "name": {
- "Phone_number_of_recipient": "recipient_name",
- "default": "default_in_place_of_name"
}
}
}
{- "number_of_recipients": 1,
- "number_of_messages": 1,
- "per_recipient": [
- {
- "recipient": 15551231234,
- "number_of_parts": 1,
- "body": "Test Message",
- "encoding": "GSM"
}
]
}
This operation returns a specific batch that matches the provided batch ID.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
batch_id required | string The batch ID you received from sending a message. Example: 01FC66621XXXXX119Z8PMV1QPQ |
OK. A successful response , or an Error.
type required | string Regular SMS | ||||||||||
id | string Unique identifier for batch | ||||||||||
to | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
canceled | boolean Default: false Indicates if the batch has been canceled or not. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
created_at | string <date-time> Timestamp for when batch was created. Formatted as ISO-8601: | ||||||||||
modified_at | string <date-time> Timestamp for when batch was last updated. Formatted as ISO-8601: | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
{- "id": "01FC66621XXXXX119Z8PMV1QPQ",
- "to": [
- 15551231234,
- 15551256344
], - "from": 15551231234,
- "canceled": false,
- "parameters": {
- "{parameter_key}": {
- "{msisdn}": 15551231234,
- "default": "string"
}
}, - "body": "Hi ${name}! How are you?",
- "type": "mt_text",
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "delivery_report": "none",
- "send_at": "2019-08-24T14:15:22Z",
- "expire_at": "2019-08-24T14:15:22Z",
- "callback_url": "myCallbackUrl",
- "client_reference": "myReference",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": true,
- "max_number_of_message_parts": 1,
- "from_ton": 6,
- "from_npi": 18
}
This operation updates all specified parameters of a batch that matches the provided batch ID.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
batch_id required | string The batch ID you received from sending a message. Example: 01FC66621XXXXX119Z8PMV1QPQ |
from | string Sender number. Must be valid phone number, short code or alphanumeric. | ||||||||||
type | string Regular SMS
| ||||||||||
to_add | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of phone numbers and group IDs to add to the batch. | ||||||||||
to_remove | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of phone numbers and group IDs to remove from the batch. | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set, in the future the message will be delayed until Constraints: Must be before expire_at. If set in the past, messages will be sent immediately. | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Constraints: Must be after Default: 3 days after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Constraints: Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
truncate_concat | boolean If set to true the message will be shortened when exceeding one part. | ||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. |
A successful response , or an Error.
type required | string Regular SMS | ||||||||||
id | string Unique identifier for batch | ||||||||||
to | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
canceled | boolean Default: false Indicates if the batch has been canceled or not. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
created_at | string <date-time> Timestamp for when batch was created. Formatted as ISO-8601: | ||||||||||
modified_at | string <date-time> Timestamp for when batch was last updated. Formatted as ISO-8601: | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
{- "to_remove": [
- "YOUR_numbers",
- "to_remove",
- "as_strings_in_array",
- "with_country_code",
- "16267890123"
], - "to_add": [
- "YOUR_numbers",
- "to_add"
]
}
{- "id": "01FC66621XXXXX119Z8PMV1QPQ",
- "to": [
- 15551231234,
- 15551256344
], - "from": 15551231234,
- "canceled": false,
- "parameters": {
- "{parameter_key}": {
- "{msisdn}": 15551231234,
- "default": "string"
}
}, - "body": "Hi ${name}! How are you?",
- "type": "mt_text",
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "delivery_report": "none",
- "send_at": "2019-08-24T14:15:22Z",
- "expire_at": "2019-08-24T14:15:22Z",
- "callback_url": "myCallbackUrl",
- "client_reference": "myReference",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": true,
- "max_number_of_message_parts": 1,
- "from_ton": 6,
- "from_npi": 18
}
This operation will replace all the parameters of a batch with the provided values. It is the same as cancelling a batch and sending a new one instead.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
batch_id required | string The batch ID you received from sending a message. Example: 01FC66621XXXXX119Z8PMV1QPQ |
body required | string [ 0 .. 2000 ] characters The message content | ||||||||||
to required | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
type | string Regular SMS
| ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be a valid URL. Learn how to set a default callback URL here. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
A successful response , or an Error.
type required | string Regular SMS | ||||||||||
id | string Unique identifier for batch | ||||||||||
to | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
canceled | boolean Default: false Indicates if the batch has been canceled or not. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
created_at | string <date-time> Timestamp for when batch was created. Formatted as ISO-8601: | ||||||||||
modified_at | string <date-time> Timestamp for when batch was last updated. Formatted as ISO-8601: | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
{- "to": [
- 15551231234,
- 15551256344
], - "body": "Hi ${name}! How are you?"
}
{- "id": "01FC66621XXXXX119Z8PMV1QPQ",
- "to": [
- "+15551231234",
- "+15551256344"
], - "from": "+15551231234",
- "canceled": false,
- "parameters": {
- "property1": {
- "property1": "string",
- "property2": "string"
}, - "property2": {
- "property1": "string",
- "property2": "string"
}
}, - "body": "Hi ${name}! How are you?",
- "type": "mt_text",
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "delivery_report": "none",
- "send_at": "2019-08-24T14:15:22Z",
- "expire_at": "2019-08-24T14:15:22Z",
- "callback_url": "string",
- "client_reference": "myReference",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": true,
- "max_number_of_message_parts": 1,
- "from_ton": 6,
- "from_npi": 18
}
A batch can be canceled at any point. If a batch is canceled while it's currently being delivered some messages currently being processed might still be delivered. The delivery report will indicate which messages were canceled and which weren't.
Canceling a batch scheduled in the future will result in an empty delivery report while canceling an already sent batch would result in no change to the completed delivery report.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
batch_id required | string The batch ID you received from sending a message. Example: 01FC66621XXXXX119Z8PMV1QPQ |
Batch deleted or an Error.
type required | string Regular SMS | ||||||||||
id | string Unique identifier for batch | ||||||||||
to | Array of strings <E.164> (MtDestination) [ 1 .. 1000 ] items List of Phone numbers and group IDs that will receive the batch. More info | ||||||||||
from | string Sender number. Must be valid phone number, short code or alphanumeric. Required if Automatic Default Originator not configured. | ||||||||||
canceled | boolean Default: false Indicates if the batch has been canceled or not. | ||||||||||
object (parameterObj) Contains the parameters that will be used for customizing the message for each recipient. | |||||||||||
body | string [ 0 .. 2000 ] characters The message content | ||||||||||
created_at | string <date-time> Timestamp for when batch was created. Formatted as ISO-8601: | ||||||||||
modified_at | string <date-time> Timestamp for when batch was last updated. Formatted as ISO-8601: | ||||||||||
delivery_report | string (DeliveryReportType) Kind of delivery report
| ||||||||||
send_at | string <date-time> If set in the future, the message will be delayed until | ||||||||||
expire_at | string <date-time> If set, the system will stop trying to deliver the message at this point. Must be after | ||||||||||
callback_url | string [ 0 .. 2048 ] characters Override the default callback URL for this batch. Must be valid URL. | ||||||||||
client_reference | string [ 0 .. 2048 ] characters The client identifier of a batch message. If set, the identifier will be added in the delivery report/callback of this batch | ||||||||||
feedback_enabled | |||||||||||
flash_message | boolean Default: false Shows message on screen without user interaction while not saving the message to the inbox. | ||||||||||
truncate_concat | boolean If set to | ||||||||||
max_number_of_message_parts | integer <int32> >= 1 Message will be dispatched only if it is not split to more parts than Max Number of Message Parts | ||||||||||
from_ton | integer <int32> [ 0 .. 6 ] The type of number for the sender number. Use to override the automatic detection. | ||||||||||
from_npi | integer <int32> [ 0 .. 18 ] Number Plan Indicator for the sender number. Use to override the automatic detection. |
{- "id": "01FC66621XXXXX119Z8PMV1QPQ",
- "to": [
- 15551231234,
- 15551256344
], - "from": 15551231234,
- "canceled": true,
- "parameters": {
- "{parameter_key}": {
- "{msisdn}": 15551231234,
- "default": "string"
}
}, - "body": "Hi ${name}! How are you?",
- "type": "mt_text",
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "delivery_report": "none",
- "send_at": "2019-08-24T14:15:22Z",
- "expire_at": "2019-08-24T14:15:22Z",
- "callback_url": "myCallbackUrl",
- "client_reference": "myReference",
- "feedback_enabled": false,
- "flash_message": false,
- "truncate_concat": true,
- "max_number_of_message_parts": 1,
- "from_ton": 6,
- "from_npi": 18
}
Send feedback if your system can confirm successful message delivery.
Feedback can only be provided if feedback_enabled
was set when batch was submitted.
Batches: It is possible to submit feedback multiple times for the same batch for different recipients. Feedback without specified recipients is treated as successful message delivery to all recipients referenced in the batch. Note that the recipients
key is still required even if the value is empty.
Groups: If the batch message was creating using a group ID, at least one recipient is required. Excluding recipients (an empty recipient list) does not work and will result in a failed request.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
batch_id required | string The batch ID you received from sending a message. Example: 01FC66621XXXXX119Z8PMV1QPQ |
A list of phone numbers (MSISDNs) that successfully received the message.
Accepted, or an Error. A successful response will return an empty 202 HTTP response, indicating that the request has been received and is processing.
{- "recipients": [
- "+15551231234",
- "+15551256344"
]
}