Send an SMS

The HTTP interface can be accessed using GET or POST. All parameters must be URL Encoded and sent as UTF-8 text.

https://api.mediaburst.co.uk/http/send.aspx

Parameters

To send a message you need to pass the following parameters.

Username & Password

Your mediaburst API username and password.

To

Up to 50 comma separated numbers. Each number should start with an international country code without any leading zeros or plus symbols.

For example our UK office would be 441625588620

Content

The message you want to send. Mobile networks only support characters listed in the GSM character set, but for consistency all characters must be UTF-8 encoded when sending through the API.

Optional Parameters

You don’t need to send these parameters, but it might make things a little nicer.

From

The text or phone number displayed when a text message is received on a phone. This can be either a 12 digit number or 11 characters long. You can set a default by logging in to your web control panel.

Long

Set this to 1 and we’ll stick together multiple messages giving you up to 459 characters, rather than the standard 160 (each recipient will cost up to 3 message credits).

API Responses

If your send was sucessful you will get a message ID back for each phone number

To: 441234567890 ID: AB_12345

If something goes wrong and none of your messages were sent you’ll get

Error 2: Invalid Username Or Password

For an invalid mobile number

To: zzz Error 10: Invalid 'To' Parameter

Examples

Successfully sending the message “Hello World” to mobile number 441234567890

https://api.mediaburst.co.uk/http/send.aspx?
username=USERNAME&password=PASSWORD&to=441234567890&content=Hello+World

To: 441234567890 ID: AB_12345

Sending the message “Hello World” to mobile number 441234567890 and invalid number zzz

https://api.mediaburst.co.uk/http/send.aspx?
username=USERNAME&password=PASSWORD&to=441234567890,zzz&content=Hello+World

To: 441234567890 ID: AB_12345
To: zzz Error 10: Invalid 'To' Parameter