Sending transactional messages using the REST API

{
    "options": {
        "usenewsletterastemplate": "true",
        "idnewsletter": 5
    },
    "values": {
        "type": "sms",
        "from": "smssender",
        "smsbody": "helloooo",
        "to": "+390000000"
    }
}

Send a list of messages

POST https://apiserver/ws/rest/api/v19/simplemessages/messages

Submit a list of messages (email or SMS) in batch mode.

Request: Refer to Common parameters section for the full list of options and values.

Result: is a list of delivery result MNSimpleMessageSendResult, one per message.

MNSimpleMessageSendResult structure:

Request Body example (send two messages with contact data, one via email and another via sms):

{
   "messages":[
      {
         "options":{
            "usecontactemail":"true",
            "idcontact":8
         },
         "values":{
            "type":"email",
            "fromemail":"email@test.informatica.it",
            "fromname":"Test",
            "subject":"Subject for you [contact:name]",
            "htmlbody":"Hello [contact:name]",
            "attachments":[
               {
                  "filename":"hello.txt",
                  "contenttype":"text/plain",
                  "body":"aGVsbG8gd29ybGQ="
               }
            ]    
         }
      },
      {
         "options":{
         },
         "values":{
            "type":"sms",
            "from":"sender",
            "smsbody":"Hello!",
            "to":"+390000000000"
         }
      }
   ]
}

Send MIME messages

POST https://apiserver/ws/rest/api/v19/simplemessages/mimemessage

If a message has been successfully sent, gets the ID of the message, otherwise it returns an error.

To use this function is required to:

• Define the mandatory parameter recipient;
• Pass the header: Content-Type: message/rfc822.

Query parameters

Result: this function returns a JSON-formatted response

POST https://mysite.com/ws/rest/api/v19/simplemessages/mimemessage?recipient=test@test.it&idcontact=5
Content-Type: message/rfc822

Submit a transactional email message to the contact that will sent as soon as possible

Request body example:

From: Test <example@example.com>
To:test@test.com
subject:My Subject
MIME-Version: 1.0
Content-Type: multipart/mixed;
        boundary="XXXXboundary text"

This is a multipart message in MIME format.

--XXXXboundary text 
Content-Type: text/plain

this is the body text

--XXXXboundary text 
Content-Type: text/plain;
Content-Disposition: attachment;
        filename="test.txt"

this is the attachment text

--XXXXboundary text--