In order to send an MMS you must post your query (with a minimum of 4 parameters) to the following URL: http://www.onesixty.co.uk/api/send-mms/. For added security, you can connect over SSL by using the following URL: https://www.onesixty.co.uk/api/send-mms/.

Parameters	Type	Information
EmailAddress (required)	String	Your email address registered at OneSixty.
Password (required)	String	Your OneSixty password.
Destination (required)	String (4,096)	A comma separated list of UK recipients. You cannot send an MMS overseas.   An international format is optional and so is the plus sign (+).   The maximum length of each recipient is 13 digits.
URL (required)	String	The URL destination of the MMS ZIP folder. For more information, click here.
Originator	String	More commonly known as the Sender ID.   This should either be 5 digits in length (e.g. 60300) or a telephone number.   The maximum length of a telephone number is 15 digits minus the length of the country calling code.
Subject	String	Can be used to set a subject for the MMS with a maximum length of 20 characters.   The following characters are allowed: @£$¥èéùìòÇØøÅå_ÆæßÉ !"#¤%&'()*+,-./:;<=>?¡ÄÖÑܧ¿äöñüàA-Za-z0-9
DeliveryReceiptURL	String	Can be used to override the default URL as specified in the OneSixty Control Panel.

The response is a string JSON array. For example:

[
	18,
	"You either do not have an account with us or you supplied an invalid password."
]

You can use the json_decode() function in PHP to convert this string into a PHP variable.

The value of the first element is an integer response code and the value of the second element is a string response. You should always check for a third element. If the value of the first element is integer 0, there always will be a third element (only in live mode). For example:

[
	0,
	"Your message has been sent successfully.",
	[
		"3b4fad2d6c6a088ad804d0dcbad45aa9":"447712345678"
	]
]

The value of the third element will be an array. There will be one or more key:value pairs in this array where key is a string submission reference and value is a comma separated list of recipients. You should store the submission reference alongside each recipient as we will post these to you along with the delivery status at a later date.

Response codes and responses

0	Your message has been sent successfully. or Your message has been queued successfully.
1	We could not find any recipients in a valid format.
4	You do not have any credits.
5	The originator contains invalid characters.
8	You have insufficient credits remaining.
9	A submission error occurred therefore your message could not be sent.
18	You either do not have an account with us or you supplied an invalid password.
19	One of the required fields are missing.
20	There is a problem with the URL destination of the MMS ZIP folder.
21	The subject field contains invalid characters or is too long.

The reason we provide you with a response message is so that you can show this directly to the end user, if you wish.

Sample code

<?php
    function SendMMS($EmailAddress = '', $Password = '', $Destination = '', $URL = '', $Originator = '', $Subject = '', $DeliveryReceiptURL = '') {
        $Parameters = 'EmailAddress=' . urlencode($EmailAddress) . '&';
        $Parameters .= 'Password=' . urlencode($Password) . '&';
        $Parameters .= 'Destination=' . urlencode($Destination) . '&';
        $Parameters .= 'URL=' . urlencode($URL) . '&';
        $Parameters .= 'Originator=' . urlencode($Originator) . '&';
        $Parameters .= 'Subject=' . urlencode($Subject) . '&';
        $Parameters .= 'DeliveryReceiptURL=' . urlencode($DeliveryReceiptURL);
        
        $Handle = curl_init();
        
        $URL = 'http://www.onesixty.co.uk/api/send-mms/';
        
        $Options = array(
            CURLOPT_URL => $URL,
            CURLOPT_POST => TRUE,
            CURLOPT_RETURNTRANSFER => TRUE,
            CURLOPT_POSTFIELDS => $Parameters
        );
        
        curl_setopt_array($Handle, $Options);
        
        $JSON = curl_exec($Handle);
        
        curl_close($Handle);
        
        return $JSON;
    }
    
    $JSON = SendMMS('email@your-domain.co.uk', 'pa$$word', '07712345678', 'http://www.your-domain.co.uk/MMS.zip');
    
    echo $JSON;
?>

The above example sends an MMS to the following recipient: 07712345678.

The parameter names are case-insensitive and underscore-insensitive, which means that EmailAddress is the same as emailAddress, emailaddress, email_address and so on. Why? Simply because it enables you to code directly against our API in a fashion that best reflects your coding style.

ZIP folder information

Your ZIP folder should contain, at the very minimum, a manifest file (in Java Properties format) and your content (text file, image, audio). We strongly recommend that you also include an SMIL file too. Here is an example manifest file with a filename of: manifest

smil.sml=application/smil
audio.mid=audio/midi
image.gif=image/gif
text.txt=text/plain

Here is an example SMIL file with a filename of: smil.sml

<smil>
	<body>
		<par dur="15000ms">
			<text src="text.txt"></txt>
			<audio src="audio.mid"></audio>
			<img src="image.gif"></img>
		</par>
	</body>
</smil>

Simply ZIP the 5 files together (manifest, smil.sml, audio.mid, image.gif, text.txt) and upload to your server as a ZIP folder. When sent as an MMS, the text and image will display for 15 seconds whilst the audio plays in the background. You can download an example MMS ZIP folder here.

Please note. The ZIP folder should be built without compression and the character set of any text files should be UTF-8.

About Us | Twitter | Our Clients | Media | Job Opportunities | Support

Open an Account | Terms of Use | Privacy Policy | © 2012 OneSixty Limited. All rights reserved.