Table of Contents
Synopsis
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, 10DLC or a TFN 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":"MMS_MO",
"code":"N401",
"from":"SENDER_PHONE_NUMBER_WITH_COUNTRY_CODE",
"to":"RECEIVER_NUMBER",
"message-subject":"SUBJECT"
"tracking-id":"TRACKING_ID",
"timestamp":"RECEIVED_TIMESTAMP",
"content":[
{
"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":"10000000000",
"to":"00000",
"message-subject":"Test34324",
"tracking-id":"MMSMOT0OTq6AK",
"timestamp":"2021-02-03T18:27:54.235957+00:00",
"content":[
{
"file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/T0OTq6AK\/0.smil"
},
{
"file":"https:\/\/fake-d2c-url.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":"10000000000",
"to":"00000",
"message-subject":"Test34324",
"tracking-id":"MMSMOkZyVKAlH",
"timestamp":"2021-02-03T17:56:45.341093+00:00",
"content":[
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/0.smil"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/IMG_5294.JPG"
},
{
"file":"https:\/\/fake-d2c-url.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":"10000000000",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMOpwSgxEQA",
"timestamp":"2021-02-03T18:39:15.999458+00:00",
"content":[
{
"file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.smil"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text0000021.txt"
},
{
"file":"https:\/\/fake-d2c-url.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":"10000000000",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMOHQfFewB0",
"timestamp":"2021-02-03T18:39:46.022285+00:00",
"content":[
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/IMG_20210203_133922_01.jpg"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text000003.txt"
},
{
"file":"https:\/\/fake-d2c-url.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":"10000000000",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMORSiyTycm",
"timestamp":"2021-02-03T19:07:05.469904+00:00",
"content":[
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":"https:\/\/fake-d2c-url.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":"10000000000",
"to":"00000",
"message-subject":"",
"tracking-id":"MMSMO6Cd3B8I9",
"timestamp":"2021-02-03T19:10:45.301647+00:00",
"content":[
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/image000002.jpg"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
},
{
"file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
},
{
"file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text000004.txt"
},
{
"file":"https:\/\/fake-d2c-url.com\/xxxxxxxxxxxx\/video000001.mp4"
}
]
}’ \
"POSTBACK_ENDPOINT_URL"