Announcing RingCentral 2-Way MMS and Group MMS APIs

John Wang
RingCentral Developers
2 min readMay 7, 2017

MMS (Multimedia Messaging Service) and Group MMS have come to the RingCentral communications API and you can now send and receive files in addition to text messages to MMS enabled mobile phones and other endpoints. When combined with SMS, these provide comprehensive text messaging capabilities.

  • MMS is popular to send and receive images, videos, vCards, and other files. Our 2-way MMS API support means that you can send and receive MMS APIs.
  • Group MMS is used to send the same messages to multiple people. With Group MMS you can send straight text or files to a group of people

The API is full featured and supports 13 file formats for outbound messages and 19 file types for inbound messages, covered in detail below.

To simplify development, the RingCentral API supports the following:

  • Single interface for for both SMS, MMS and Group MMS: The API will automatically select between SMS and MMS behind the scenes based on the data being sent.
  • Similar format to our fax API supporting multipart/mixed and multipart/form-data request formats for ease of use.

Supported File Types

Our initial release supports 13 filetypes for sending outbound messages and 19 filetypes for receiving inbound messages. File categories include images, videos, vCards, archives, and other files.

Outbound Message Types

The 13 supported outbound file types are listed below by Content Type:

Inbound Message Types

The 19 supported inbound file types are listed below by Content Type:

The API

The API is part of our REST API suite and both described in our API Reference and covered by our SDKs.

In general, the API is very similar to the RingCentral fax API and supports including files via the multipart/mixed Content-Type. For sending messages to multiple recipients via Group MMS, simply add multiple recipients to the “to” array.

Example Code

Here is some example PHP code from the RingCentral PHP SDK:

You can find example code in the the following official and community SDKs:

HTTP

The following example request and response uses a multipart/mixed request format and is listed in our API Reference.

Example Request

Example Response

Try It Out!

The RingCentral MMS and Group MMS APIs are available to try out now! Please contact our Platform Team if you have any questions.

--

--

John Wang
RingCentral Developers

AVP Platform Products for @RingCentral with a focus on improving life through innovative products and software