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.

By
William Teig
Published on
December 13, 2023
Contributors
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.

Security

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.

Authentication

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.

Throttling

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.”

Pagination

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.

Contributors
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

Crafting the Perfect Mother's Day SMS/MMS Campaign with Cellcast

Leveraging Cellcast for your Mother's Day campaign can help you deliver messages that not only resonate with your audience but also drive engagement and sales. Here's how to construct a perfect SMS/MMS campaign for Mother's Day with Cellcast.

Bulk SMS for Nonprofit Organisations

In today's fast-paced world, capturing and maintaining an audience's attention is crucial, especially for non-profit organisations in Australia striving to promote their missions and engage supporters.

Navigating Bulk SMS Marketing Challenges to Craft Effective Engagement

This comprehensive guide delves deep into the challenges Australian businesses frequently encounter in Bulk SMS Marketing. More importantly, we unveil actionable solutions that empower businesses to overcome these obstacles and elevate their SMS marketing endeavors into genuine, value-driven engagements.
No items found.