(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.data-privacy-src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-TT9ZP96');

Knowledge Base

MMS MT Postback V2

When the MMS is sent we will generate a Postback notification. When we receive an MMS delivery receipt we will generate another Postback notification. Not all carriers provide MMS delivery receipts.

MMS MT Success/Failure Status Codes

Postback CodePostback Status
N101Sent
N102Delivered
N103Expired
E101Failed
E102Rejected
N003Transcoding successful
E002Transcoding failed for audio
E003Transcoding failed for video
N013Transcoding successful and sending triggered
E011Content validation failures
E012Transcoding failed for audio and sending not triggered
E013Transcoding failed for video and sending not triggered

MMS MT Postback Nodes

Postback ParameterPostback Parameter Description
originMMS_MT
codePostback Notification code to identify the postback.
sent-asValue is “MMS” if the MMS is sent/delivered as MMS. Value is “SMS” if the MMS is sent/delivered as Fallback SMS.
statusStatus of the MMS MT transaction. Example: Sent, Delivered, Failed, Rejected, Expired.
status-detailsStatus Details of the MMS MT transaction. Example: Message Sent, Message Delivered, Message Failed, Message Rejected, Message Expired.
toDestination phone number with country code.
fromThe shortcode or longcode sender.
timestampThe timestamp for the MMS MT transaction.
operator-idCarrier ID for the Phone Number.
operator-nameCarrier Name for the Phone Number.
tracking-id / trackingidTracking ID generated in the API Response passed back in the postback to link API Request to Postback.
client-referenceCustomer transaction ID passed back in the postback to link API Request to Postback.
campaign-refMessaging Campaign Reference ID from the API Request.
from-maskSender Mask for the Sender used to send the message. Sent in the postback only if it exists.
mms-id / mmsidThe mms template id value of the template that will be created.
handsetHandset profile returned inside Delivery Receipt. This is present only in N102 notification.
audio-name / audionameAudio file URL provided in the request.
video-name / videonameVideo file URL provided in the request.
content-type Content type.
content-nameContent file URL provided in the request.
error-infoError information for the failure.

POSTBACK: N101/N102/N103/E101/E102 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "sent-as":"MMS/SMS",
          "status":"STATUS",
          "status-details":"STATUS_DETAILS",
          "mms-id":"MMS_ID",
          "from":"SENDER_NUMBER",
          "to":"RECEIVER_PHONE_NUMBER_WITH_COUNTRY_CODE",
          "tracking-id":"TRACKING_ID",
          "client-reference": "CLIENT_REFERENCE",
          "operator-id":"CARRIER_ID",
          "operator-name":"CARRIER_NAME”
          "timestamp":"SENT_TIMESTAMP",
          "handset":"HANDSET_ID"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N101 Example (MMS MT Sent)

MMS
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N101",
          "sent-as":"MMS",
          "status":"Sent",
          "status-details":"Message Sent",
          "mms-id":”123456",
          "from":"00000",
          "to":"11111111111",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          “operator-name”:”AT&T”,
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Fallback SMS
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N101",
          "sent-as":"SMS",
          "status":"Sent",
          "status-details":"Message Sent",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          “operator-name”:”AT&T”,
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N102 Example (MMS MT / Fallback SMS Delivered)

MMS
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N102",
          "sent-as":"MMS", 
          "status":"Delivered",
          "status-details":"Message Delivered",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          “operator-name”:”AT&T”,
          "timestamp":"2021-01-26T18:00:07.990498+00:00",
          "handset":"iosmms2.0"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Fallback SMS
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N102",
          "sent-as":"SMS", 
          "status":"Delivered",
          "status-details":"Message Delivered",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00",
          "handset":"iosmms2.0"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N103 Example (MMS MT Expired)

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N103",
          "sent-as":"MMS",
          "status":"Expired",
          "status-details":"Message Expired",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E101 Example (MMS MT Sending Failed)

MMS is too BIG (Fallback SMS is disabled)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E101",
          "sent-as":"MMS",
          "status":"Failed",
          "status-details":"MMS is too big",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

No way to send SMS or MMS
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E101",
          "sent-as":"MMS",
          "status":"Failed",
          "status-details":"No way to send MMS or SMS",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Internal Routing Error
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E101",
          "sent-as":"MMS",
          "status":"Failed",
          "status-details":"Internal Routing Error",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Content Validation Failed
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E101",
          "sent-as":"MMS",
          "status":"Failed",
          "status-details":"Content Validation Failed",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Audio or Video Transcoding Failed
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E101",
          "sent-as":"MMS",
          "status":"Failed",
          "status-details":"Audio or Video Transcoding Failed",
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E102 Example (MMS MT Rejected)

Rejected
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E102",
          "sent-as":"MMS",
          "status":"Rejected",
          "status-details":"Message Rejected", 
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Unreachable
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E102",
          "sent-as":"MMS",
          "status":"Rejected",
          "status-details":"Network Unreachable", 
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

Not Supported
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E102",
          "sent-as":"MMS",
          "status":"Rejected",
          "status-details":"Message Not Supported", 
          "mms-id":"123456",
          "from":"10000000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N003 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "mmsid":"MMS_ID_OF_NEW_MMS_TEMPLATE_CREATED",
          "tracking-id":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "timestamp":"TIMESTAMP_TRANSCODED"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N003 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N003",
          "mmsid":"123456",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E002 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "mmsid":"MMS_ID_OF_NEW_MMS_TEMPLATE_CREATED",
          "trackingid":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "audioname":"AUDIO_FILE_URL_PROVIDED_IN_THE_REQUEST"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E002 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E002",
          "mmsid":"123456",
          "trackingid":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "audioname":"https:\/\/fake-content-url.com\/audio.mp3"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E003 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "mmsid":"MMS_ID_OF_NEW_MMS_TEMPLATE_CREATED",
          "trackingid":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "videoname":"VIDEO_FILE_URL_PROVIDED_IN_THE_REQUEST"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E003 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E003",
          "mmsid":"123456",
          "trackingid":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "videoname":"https:\/\/fake-content-url.com\/video.mp3"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N013 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "mms-id":"MMS_ID_OF_NEW_MMS_TEMPLATE_CREATED",
          "tracking-id":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "timestamp":"TIMESTAMP_TRANSCODED"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N013 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"N013",
          "mms-id":"123456",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E011 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "tracking-id":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "content-type":"CONTENT_TYPE", 
          "content-name":"CONTENT_FILE_URL_PROVIDED_IN_THE_REQUEST",
          "error-info":"REASON_FOR_CONTENT_VALIDATION_FAILURE"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E011 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E011",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "content-type":"video", 
          "content-name":"https:\/\/fake-content-url.com\/video.mp4",
          "error-info":"Video for slide 1 not found at url. Content cannot be fetched from the URL."
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E012 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "tracking-id":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "audio-name":"AUDIO_FILE_URL_PROVIDED_IN_THE_REQUEST",
          "error-info":"TRANSCODING_FAILED_FOR_AUDIO"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E012 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E012",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "audio-name":"https:\/\/fake-content-url.com\/audio.mp3",
          "error-info":"Transcoding failed for audio"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E013 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"ORIGIN",
          "code":"STATUS_CODE",
          "tracking-id":"TRACKING_ID_OF_REQUEST",
          "client-reference": "CLIENT_REFERENCE",
          "video-name":"VIDEO_FILE_URL_PROVIDED_IN_THE_REQUEST",
          "error-info":"Transcoding failed for video"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E013 Example

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MT",
          "code":"E013",
          "tracking-id":"xxxxxxxxxxxx",
          "client-reference": "5ZY7Cx1Xy0vs",
          "video-name":"https:\/\/fake-content-url.com\/video.mp4",
          "error-info":"Transcoding failed for video"
      }’ \
  "POSTBACK_ENDPOINT_URL"
Go to Top