Transmit a text message using Cellcast’s RESTful API

Send MMS messages with our MMS messaging API.
Obtain real-time delivery information for all messages sent (DLR).
Send and receive responses through SMS.

Multimedia Messaging Service is known as MMS. To make it possible to send multimedia files together with text messages, the Multimedia Messaging Service (MMS) was created as an add-on to the SMS standard.

Because of the higher data transmission costs associated with MMS communications, they are more expensive than SMS messages.

What’s the point of paying extra for MMS if you don’t get a 20% higher opt-in rate and an 8x greater chance of your message being shared on social media? MMS is more expensive, but it’s worth it because pictures and animations are more interesting to look at than plain text.

Your clients or subscribers will have a better mobile experience using MMS. A picture is worth a thousand words, right?

You can be up and running with our REST API in just a few minutes by following the Quick Start tutorial. Check out our reference manuals for more in-depth functions and calls for advanced users. We’ve received several requests to make the site more user- and reseller-friendly by mirroring useful features. We also provide code samples to help you get the most out of the API suite.

Using this as a springboard, let’s explore REST API use and optimisation strategies.


All API queries must be sent over the HTTPS protocol in order to maintain user privacy and security. Make sure you make MMS requests through your server, not directly from the browser, in order to protect yourself from unauthorised charges, since this will expose your API secret and open the door to undesired charges.


We will supply you with an APPKEY that you may use for any API calls. Rather than as CGI arguments, API credentials must be sent via HTTP Basic Authentication headers.


We set a restriction of 15 API requests per second per account to ensure that all of our clients receive the best possible service. Please contact us if you are a heavy user and want to raise your throttling speed. If you go above this limit, we will return two indications that you may use in your code to tell if you’ve been throttled. A 429 means “Too Many Requests,” while an error code “OVER LIMIT” in the response body means “Too Many Limits Have Been Exceeded.”


We paginate some replies because they are too huge to return all at once. The “page” arguments in the parameter descriptions for each API call can be used to determine which requests employ pagination. ‘count’ and ‘number’ are the values returned in a ‘page’ block for these calls. There are a total of pages, and the page number you are currently seeing is indicated by the number. In order to get a specific URL, you can use the page argument, which defaults to 1.

Reporting of Errors

Keep an eye on whether or not your API call is working as expected. The following may be of interest:

The response header for this request reads “200 OK.” If there is a mistake, the number will be 4xx.
‘SUCCESS’ should be the value for the error->code structure.
Keep in mind that certain API methods have the capability to return their own unique errors (listed in appropriate document sections). To learn more about what went wrong, or what resources you don’t have access to, click on the error->description link and read the explanation there.
We’re excited to see what you come up with.

By Andrew Kelly | Categories: Cellcast SMS & MMS

About the Author: Andrew Kelly

After completing a PHD in telecommunications Andrew found himself as interested in the literature as the technology itself. Andrew now writes engaging and informative prose at Cellcast sunny office in Melbourne, for offices across the globe.

WordPress Video Lightbox Plugin