Send binary SMS message

POST https://{baseUrl}/sms/2/binary/advanced

This API allows you to send binary SMS messages, which can be used for sending encoded data, such as ringtones, WAP push messages, or binary data.

Request Headers

Header	Type	Description	Required
Content-Type	string	Must be "application/json".	Yes
Authorization	string	API key for authentication (Bearer <your_api_key>).	Yes

Request Body

Root Object

Field	Type	Description	Required
bulkId	string	Unique identifier for the bulk request.	No
messages	array<object>	List of binary SMS messages to be sent.	Yes

messages (Array of Objects)

Field	Type	Description	Required
binary	object	Encoded binary message data.	Yes
callbackData	string	Data sent in the delivery report callback.	No
destinations	array<object>	List of message recipients.	Yes
from	string	Sender name or number.	Yes
intermediateReport	boolean	Whether intermediate delivery reports should be sent.	No
notifyContentType	string	Content type for notifications.	No
notifyUrl	string	URL for delivery report callbacks.	No
validityPeriod	integer	Message validity period in minutes.	No
campaignReferenceId	string	Identifier for a campaign-related message.	No
sendAt	string (ISO 8601)	Scheduled time for sending the message.	No
deliveryTimeWindow	object	Specifies time restrictions for message delivery.	No

binary Object

Field	Type	Description	Required
dataCoding	integer	Data encoding scheme (e.g., 0 for default GSM encoding).	Yes
esmClass	integer	Messaging mode and type (e.g., 0 for default).	Yes
hex	string	Encoded binary data in hexadecimal format.	Yes

destinations (Array of Objects)

Field	Type	Description	Required
messageId	string	Unique identifier for the message.	No
to	string	Recipient phone number in international format.	Yes

deliveryTimeWindow Object

Field	Type	Description	Required
days	array<string>	List of allowed delivery days (e.g., "MONDAY", "TUESDAY").	Yes
from	object	Start time for delivery window.	Yes
to	object	End time for delivery window.	Yes

from / to Objects (Inside deliveryTimeWindow)

Field	Type	Description	Required
hour	integer	Hour of the day (0-23).	Yes
minute	integer	Minute of the hour (0-59).	Yes