Using Our APIs
Commands
Add Customer
5 min
purpose customers can be assigned to sims to support reporting and to provide user access limited to sims belonging to a specific customer the new customer name is specified using the \<customer> element \<customer> must be a unique string within your account maximum length 50 characters empty values or names that already exist on your account will return an invalid content response data must be entered as plain text reserved xml characters must be escaped as described in the xml format section operational impact api commands perform live configuration changes changes take effect immediately commands may affect sim status, service availability, charging, or usage limits requests cannot be undone automatically ensure all parameters are validated before submitting requests to the production environment endpoint post https //api m2miportal com content type application/xml accept application/xml request (xml) \<add customer version="1" api id="123456"> \<authentication> \<username>username\</username> \<password>password\</password> \</authentication> \<customer>global trading\</customer> \</add customer> response (success) \<add customer response api id="123456"> \<api outcome>success\</api outcome> \</add customer response> response (failure) if a request cannot be processed, the response will include api outcome indicating failure an error description explaining the reason failure responses may occur due to invalid authentication credentials invalid or unknown identifiers (for example iccid or msisdn) invalid or missing parameters values not permitted for the specified sim type or account configuration insufficient permissions integrating systems should validate input data before submission and implement appropriate error handling and logging