Sign in
messaging

Send binary message

Sends a binary message to a list of recipients

post/smsmessaging/binary

Request body

recipientAddressListinteger[] required

List of recipients (E164 formatted MSISDNs - see Wikipedia en.wikipedia.org/wiki/MSISDN) to whom the message should be sent. The list of recipients may contain a maximum of 1000 entries.

senderAddressstring

Optional. Address of the sender (assigned to the account) from which the message is sent.

senderAddressType'national' | 'international' | 'alphanumeric' | 'shortcode'

Optional. The sender address type. The following address types are supported: national, international, alphanumeric or shortcode).

contentCategory'informational' | 'advertisement'

Optional. The content category that is used to categorize the message (used for blacklisting). The following content categories are supported: informational or advertisement. If no content category is provided, the default setting is used (may be changed inside the onlinesms web interface).

notificationCallbackUrlstring

Optional. When setting a notificationCallbackUrl all delivery reports are forwarded to this URL.

clientMessageIdstring

Optional. May contain a freely definable message id.

priorityinteger

Optional. Priority of the message. Must not exceed the value configured for the account used to send the message. For more information please contact our customer service.

testboolean

Optional. true: The transmission is only simulated, no SMS is sent. Depending on the number of recipients the status code 2000 or 2001 is returned. false (default): No simulation is done. The SMS is sent via the SMS Gateway.

validityPeriodeinteger

Optional. Specifies the validity periode (in seconds) in which the message is tried to be delivered to the recipient. A minimum of 1 minute and a maximum of 3 days are allowed.

sendAsFlashSmsboolean

Optional. true: The message is sent as flash SMS (displayed directly on the screen of the mobile phone). false (default): The message is sent as standard text SMS

messageContentstring[]

Optional. Array of Base64 encoded binary data. Every element of the array corresponds to a message segment. The binary data is transmitted without being changed (using 8 bit alphabet)

userDataHeaderPresentboolean

Optional. true: Indicates the presence of a user data header in the messageContent property. false (default): Indicates the absence of a user data header in the messageContent property.

Example request

{
  "senderAddress": "4369912345678",
  "senderAddressType": "international",
  "contentCategory": "informational",
  "notificationCallbackUrl": "https://user:pass@myservice.com/myservice/",
  "clientMessageId": "myUniqueId",
  "priority": 5,
  "validityPeriode": 300
}

Response

OK

Changes