Table of Contents
The MMS MO postback API notifies you that a customer has replied to your number. To receive MMS MO postback, you need to work with your account manager to provision your account. Once the MMS MO postback is enabled, you will start receiving postbacks for each MMS MO received. This postback notifies you when an MMS MO is received.
MMS MO Postback Nodes
| Postback Parameter | Postback Parameter Description |
| code | N401 |
| origin | MMS_MO |
| from | The phone number including the country code of the sender. |
| to | The shortcode or longcode recipient. |
| message-subject | The subject field of the MMS if it exists. Subjects are optional. |
| tracking-id | The transaction ID for the MMS MO that occurred. |
| timestamp | The timestamp of the MMS MO received by our server. |
| content | Contains the file nodes sent in the MMS MO. |
| file | A series of sub-nodes that contains a single URL to a picture, video, audio or text file sent in the MMS MO within each node. The URL points to the location of the content on our servers. For those developing the back-end handling of the postback URL, you may choose to download/store these content files for whatever purpose you see fit. You may also choose to store the URLs for download at a future time. The file will be removed based on the terms of your contract. |
POSTBACK: N401 Request
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"{Origin}",
"code":"{Status code}",
"from":"{Sender phone number with country code}",
"to":"{Receiver number}",
"message-subject":"{Subject}"
"tracking-id":"{Tracking id}",
"timestamp":"{Timestamp}",
"content":[
{
"file":"{File URL}"
},
{
"file":"{File URL}"
},
...
]
}’ \
"{Postback Endpoint URL}"
POSTBACK: N401 Examples (MMS MO Received)
VIDEO ONLY (Verizon - iPhone7)
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"Test34324",
"tracking-id":"MMSMOT0OTq6AK",
"timestamp":"2021-02-03T18:27:54.235957+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/T0OTq6AK\/0.smil"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/IMG-0381s.3gp"
}
]
}’ \
"{Postback Endpoint URL}"
IMAGE + TEXT (Verizon - iPhone7)
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"Test34324",
"tracking-id":"MMSMOkZyVKAlH",
"timestamp":"2021-02-03T17:56:45.341093+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/0.smil"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/IMG_5294.JPG"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/text_1.txt"
}
]
}’ \
"{Postback Endpoint URL}"
VIDEO + TEXT (Sprint - Google Pixel3)
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMOpwSgxEQA",
"timestamp":"2021-02-03T18:39:15.999458+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/smil.smil"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/text0000021.txt"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/video0000001.mp4”
}
]
}’ \
"{Postback Endpoint URL}"
VIDEO + IMAGE + TEXT (AT&T - Moto)
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMOHQfFewB0",
"timestamp":"2021-02-03T18:39:46.022285+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/IMG_20210203_133922_01.jpg"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/text000003.txt"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/video000000.mp4"
}
]
}’ \
"{Postback Endpoint URL}"
AUDIO + TEXT (AT&T - Moto)
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMORSiyTycm",
"timestamp":"2021-02-03T19:07:05.469904+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/text000002.txt"
}
]
}’ \
"{Postback Endpoint URL}"
AUDIO + VIDEO + TEXT + IMAGE
curl -X POST \
-H "content-type: application/json" -d '
{
"origin":"MMS_MO",
"code":"N401",
"from":"11111111111",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMO6Cd3B8I9",
"timestamp":"2021-02-03T19:10:45.301647+00:00",
"content":[
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/image000002.jpg"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":"https:\/\/d2c.customdomain.com\/mmsmo\/xxxxxxxxxxxx\/text000004.txt"
},
{
"file":"https:\/\/d2c.customdomain.com\/xxxxxxxxxxxx\/video000001.mp4"
}
]
}’ \
"{Postback Endpoint URL}"