Documentation

Overview

The Mogreet API lets you send and receive text or multimedia messages in minutes. You can also use our platform to transcode, host and send video, audio and images.

If haven't registered yet, create a free account here to receive your API credentials. 

Once you've signed up, we will send you an email with your account information, API client_id and authentication token. You can also retrieve these credentials in your Dashboard.

Request format

Requests should be sent as an HTTPS GET or POST request to:

https://api.mogreet.com/moms/object.method

All requests require SSL protocol to provide encryption and secure identification of the server. In addition, your client id and token are required parameters for every request. The following example shows the common structure of all HTTPS GET requests understood by our servers: 

https://api.mogreet.com/moms/object.method?client_id=123456&token=abcdef&parameter=value...

If your client_id and token do not match, or if some other request parameter does not belong to the given client, your request will fail with a 403 Forbidden response.


Overview of MoMS API Objects and Methods

The following is a simple table of the available SMS/MMS Messaging API calls. Read a description of each API method in the Sending and Receiving sections of the documentation.

Object Method Request URL:
system ping https://api.mogreet.com/moms/system.ping
transaction send https://api.mogreet.com/moms/transaction.send
transaction lookup https://api.mogreet.com/moms/transaction.lookup
user getopt https://api.mogreet.com/moms/user.getopt
user setopt https://api.mogreet.com/moms/user.setopt
user uncache https://api.mogreet.com/moms/user.uncache
user info https://api.mogreet.com/moms/user.info


There are other API calls, and more reference information, available via downloadable pdf. You can download a pdf version of the full API reference Mogreet Messaging System API 4.01.pdf.

Response format

Mogreet can respond to your request with XML or JSON formats. By default a successul call will receive the following XML response:

<!--?xml version="1.0" encoding="UTF-8"?-->
<response code="1" status="success">
<message>API response message </message>
</response>

To receive a JSON response, simply add the parameter format=json to your requests.

{
   "response":{
      "code":"1",
      "status":"success",
      "message":"API response message"
   }
}

Error codes

The complete list of HTTP status and error codes can be found here.