In Version 3.0, we’ve made several changes to the MessageAPI, primarily to support International Messaging. As part of the changes necessary for international numbers, additional requested items/features that require new XML attributes have also been added to provide more robust Application Program Interfaces (APIs).
International Support Changes
- International format: All MDNs are now required to be in the International E.164 format, which is a +, followed by the country code, followed by the dial-able number. For example, +18475551212, where 1 is the code for North America. This includes parameters in the XML body, as well as cases when the URL contains an MDN.
- Ten-character restriction removed: MDNs are no longer restricted or enforced to be 10 characters. MDNs can be up to 15 digits in length plus the '+' sign. Future validation checks may be put in place to ensure the correct number of digits for certain countries, but those would not change the API specifications.
Carrier in Message Responses
Carrier is now included in outgoing message responses. This is especially useful in cases when the carrier was not specified and was looked up by the API. This applies to the submitMtMessage response.