Send Message

POST

https://api.connect.xleadfunnel.com/v1/mms/send

This is to send MMS message, each request is to send to one recipient.

Request

Body Params application/json

Example

// send to Hong Kong
{
    "sender": "xlead",
    "country_code": "852",
    "mobile": "91234567",
    "subject": "X'mas Offer",
    "boundary": "----=ba636b7798f13bf670dd002d55ecd3d3",
    "smil": "<refernce below smil content>",
    "send_also_ofca_registers": false
}

// smil content showing image on top and text below
// below follows standard layout with image on top, text bottom
----=ba636b7798f13bf670dd002d55ecd3d3
Content-Type: application/smil
Content-Location: mms.smil

<smil>
  <head>
    <layout>
      <root-layout width="320" height="320"/>
      <region id="Image" top="0" left="0" width="320" height="200" fit="meet"/>
      <region id="Text" top="200" left="0" width="320" height="120" fit="scroll"/>
    </layout>
  </head>
  <body>
    <par dur="8000ms">
      <img src="photo.jpg" region="Image"/>
      <text src="text.txt" region="Text"/>
    </par>
  </body>
</smil>

----=ba636b7798f13bf670dd002d55ecd3d3
Content-Type: image/jpeg
Content-Transfer-Encoding: base64
Content-Location: photo.jpg

// your real base64 here encoded from photo.jpg
/9j/4AAQSkZJRgABAQEAAAAAAABJ/9k=  

----=ba636b7798f13bf670dd002d55ecd3d3
Content-Type: text/plain; charset=utf-8
Content-Location: text.txt

// your real text from text.txt
Special offer – 50% off today only!  

----=ba636b7798f13bf670dd002d55ecd3d3

Responses

🟢200Success

application/json

Body

Example

// valid send request
{
    "rc": 100,
    "rm": "OK",
    "ref_id": "145737475"
}

// invalid send request
{
    "rc": -100,
    "rm": "Missing sender, your region requires Sender ID to send out messages."
}

Modified at 2025-12-09 06:11:23

Message Delivery Flow

Get Usage Report