Sending a binary data SMS message using HTTP
Overview
This page describes how to send a binary data message through the SMS Gateway. This request type is commonly used to send binary information to a specific port or application on an end user's cell phone.
For information about integrating with the SMS Gateway, see either Sending a Single SMS or Broadcasting an SMS.
Sending binary data as an SMS message
| Single-recipient end points: |
http://sms.openmarket.com/sms/v1/send https://sms.openmarket.com/sms/v1/send |
| Broadcast end points: (HTTP POST only) |
http://sms.openmarket.com/sms/v1/bulksend https://sms.openmarket.com/sms/v1/bulksend |
Example single-recipient request:
http://sms.openmarket.com/sms/v1/send?This sends the binary content 0x01020304 to port 0x1234 on the cell phone, from the account MyMXOneAccount, with password P4ssw0rD, to the recipient 12515550100.
Mandatory parameters:
| Parameter | Description | |
| user | The SMS Gateway account you are sending the message through. | |
| pass | The password for the SMS Gateway account. | |
| smsto | The MSISDN of the message recipient in international format (e.g. 12515550100). No leading "+" is required.
If you are sending a broadcast SMS request, separate each MSISDN with a line break (e.g. smsto=12515550100%0A12515550123%0A12515550145). | |
| smsmsg | The 8-bit binary content you are sending. You must hexadecimal encode the data. | |
| smsudh | The UDH information, in the format of octet pairs in decimal notation, e.g. 06050430393039. | |
Optional parameters specific to this request type:
There are no optional parameters specific to sending a Binary Data message request.
Optional parameters you can use for any request type:
- smsfrom: sets the originator for the message—this parameter is mandatory for standard rate messages in all regions bar the US
- submitid: used to send broadcast SMS messages
- report: sets the delivery reports you want for the message
- response: (for single-recipient requests only) changes the format of the HTTP response from the SMS Gateway
- note, subaccount: optional reporting notes that you can add to the request
- vp, billingsingleshot: alters the validity period and billing for the SMS message
- purpose: (US only) adds message purpose details required by Verizon for Premium Rate services
- optin1, optin1ts, optin2, optin2ts: (US only) adds opt-in details required by T-Mobile US for Premium Rate services
