5 min read

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.

William Teig
Published on
July 12, 2023
Table of Contents
William Teig
Head of Marketing
Subscribe to newsletter
By subscribing you agree to with our Privacy Policy.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

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.

William Teig
Head of Marketing
Subscribe to newsletter
By subscribing you agree to with our Privacy Policy.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Read more from our blog

Black Friday SMS Marketing Guide + FREE 14 Templates

2024 Black Friday SMS and MMS Marketing Guide and Campaign Templates

Strategies for Building a High-Quality Bulk SMS Subscriber List

In a world where smartphones are our constant companions, each buzz and ping holds the promise of a new connection. This modern communication landscape has given rise to the power of Bulk SMS Marketing. This dynamic tool can ignite your business growth and establish a direct line to your audience's pockets. Imagine reaching your customers instantly with compelling offers, timely updates, and engaging content.

Bulk SMS for Small Businesses

Australia, with its bustling cafes, trendy boutiques, and innovative startups, is no stranger to the challenges of effective marketing. How does a small business in Melbourne, Sydney, or Brisbane grab attention amidst the noise? The answer lies not in the complex but in the concise: Bulk SMS. Enter the realm of Bulk SMS marketing – a powerful and efficient tool that holds the potential to transform the way you engage with your customers. Imagine instantly reaching a group of potential clients, delivering your message directly to their mobile phones, and witnessing your business thrive as a result.
No items found.