Synchronous Errors

This page lists all error codes and corresponding error messages for the synchronous API responses.

Error Format

All error messages are returned as SOAP faults. The <faultcode> is composed of an M2M service name, a period, and one of the error codes listed in the tables on this page. For example:

The error messages in the tables are returned as the <faultstring> in a SOAP fault.

The best practice is to write your code to look for the error code values, not the service names or error messages.

To see the list of error codes and error messages for the asynchronous Callback API responses, see Callback Errors.

General Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.Request.InvalidCharacter There was an invalid character (' or < or \) in your input. One of the fields in the request had an illegal character. Do not use the apostrophe, less than sign, or backslash in your input.
INPUT_INVALID.RequestUndefined Request cannot be blank. Please provide request details. The incoming request message is empty. Verify your code to be sure that you are sending a complete SOAP request for the specific API.
REQUEST_FAILED.UnexpectedError Unexpected error occurred. Could not complete request. The request was missing required elements, had invalid parameter values, or an unknown problem occurred. Verify all required and optional field values and then retry the request. If you receive this error a second time, contact Customer Support at 800.922.0204 for assistance.
DeserializationFailed The formatter threw an exception while trying to deserialze... Expecting element 'element name'. The required element element name was not included in the request Verify all required and optional field values and then retry the request. If you receive this error a second time, contact Customer Support at 800.922.0204 for assistance.

Session Token Errors

Error Code Error Message Occurs When Resolution
REQUEST_FAILED.SessionToken.Expired The Session has expired. An API request was sent with an expired session token in the header. (Session tokens expire after 20 minutes of inactivity.) Log in again to obtain a new session token, and then retry the request with the new token.
REQUEST_FAILED.SessionToken.Format The token is not passed in the correct format. The session token was not in the SOAP header. Verify that your application is including the session token in the SOAP header.
INPUT_INVALID.SessionToken.Invalid The session token was not a valid GUID. The token in the request header was not a valid session token. Verify that your application is storing the session token returned by the LogIn API method and including it in the SOAP header.

Account Name Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.Account.NotDefined Account name is a required field. The request did not include an account name. Include an account name and send the request again.
REQUEST_FAILED.AccountName The specified contact is not associated with the specified account or the account name cannot be found. The web services username that you signed in with is not associated with the account name given in the request. Verify that you are using the correct login credentials for the account that you want to work with.
REQUEST_FAILED.AccountNotFound Could not find account "{account name}". The account name given in the request does not exist in the M2M Platform. Verify the spelling of the account name and retry the request.
REQUEST_FAILED.NoAccounts The contact has no associated accounts. The web services username that you signed in with is not associated with any accounts. Verify that you are using the correct login credentials for the account that you want to work with.
REQUEST_FAILED.MultipleAccounts The Contact is associated with multiple accounts. Please supply account name. The web services username that you signed in with has access to more than one account, and you did not include an account name in the request. AccountName is a required field when you have access to multiple accounts. Specify the account that you want to use in the API request.

Device Identifier Validation Errors

The APIs that accept device identifiers check for validity of those identifiers according to the rules described here.

The Kind element specifies the type of identifier, such as MEID, ESN, or MDN. The Identifier element specifies the value of the identifier. Depending on the Kind of the device identifier, the Identifier element text string could contain:

You do not need to prepend identifier values with the "0x" or "0h" prefix to indicate that a value is decimal or hexadecimal. The M2M Platform sends an INPUT_INVALID.Device.Identifier.Invalid SOAP fault if the identifier is not in the format required by the Kind element.

Error Code Error Message Occurs When Resolution
INPUT_INVALID.BothDeviceListAndDeviceFiltersDefined Only one of a non-empty device list or device input filter criteria (group, custom fields, service plan) may be defined in the request, but not both. Your request included a DeviceList and a DeviceGroupName, DeviceServicePlanFilter, or DeviceCustomFieldFilter. You cannot use filters if you use a DeviceList. Retry the request with just a DeviceList, or with one or more of the filters.
INPUT_INVALID.Device.Identifier.Invalid The device's {device identifier kind} was not in a valid format. The value of the Identifier element within a DeviceIdentifier element was not in the format required by the Kind element. Set the Identifier element to a value that is in the format required by the Kind element, and then resend the request.
INPUT_INVALID.Device.Identifier.NotDefined The Identifier value of Device must contain a value. An Identifier child element within a DeviceIdentifier element did not have a value. Set the Identifier element to a value that is in the format required by the Kind element, and then resend the request.
INPUT_INVALID.Device.Identifier.Null A device identifier in the collection cannot be null. The request included a null DeviceIdentifier in the DeviceIdentifierCollection. Verify that you are setting at least one Kind and Value for each DeviceIdentifier in the DeviceIdentifierCollection, and then retry the request.
INPUT_INVALID.Device.Kind.Invalid The device kind was not recognized as valid. Valid ones are ICCID, MEID, IMSI, MDN, IMEI, MSISDN, or ESN. The "Kind" field for DeviceIdentifer did not contain a recognized value. Retry the request with "Kind" set to one of the valid values.
INPUT_INVALID.Device.Kind.NotDefined The Kind value of Device must contain a value. The "Kind" field for DeviceIdentifer was empty. Retry the request with "Kind" set to one of the valid values.
INPUT_INVALID.DeviceListAccountNameAndDeviceGroupDefined Account, device list, and device group are not a valid combination. Please provide one or a valid combination (device list + account or device group + account) The request included both DeviceList and DeviceGroupName parameters, which is not a valid combination. Remove the DeviceList or DeviceGroupName parameter and then retry the request.
INPUT_INVALID.DuplicateDeviceKindInCollection Two device identifiers in the collection cannot have the same kind. Two device identifiers in a DeviceIdentifierCollection had the same value for Kind. Most requests only need one device identifier per device. If you need to provide two, they must be different Kinds.
INPUT_INVALID.NoDeviceIdentifierInCollection A device identifier collection must have at least one device identifier. The DeviceIdentifierCollection element in the request did not contain any DeviceIdentifier elements. Include at least one DeviceIdentifier element in the DeviceIdentifierCollection.
INPUT_INVALID.NoDeviceListAccountNameOrGroup Account, device list, and device group are empty. Please provide a valid combination. The request did not include any parameters to identify the devices to work with. Add a DeviceList, or DeviceGroupName and AccountName, and then retry the request.
INPUT_INVALID.NoDeviceListOrDeviceFilters The request must have either a non-empty device list or device input filter criteria (group, custom fields, service plan) defined. Your request did not include a DeviceList or a DeviceGroupName, DeviceServicePlanFilter, or DeviceCustomFieldFilter. Create the request with either a DeviceList, or one or more of the filters.
REQUEST_FAILED.DeviceNotFound Could not find device "{kind} {identifier}". The device identifier in the request did not match any devices in the account. Verify the device identifier and retry the request.

Device Custom Field Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.CustomField.InvalidName Only the values CustomField1, CustomField2, CustomField3, CustomField4, and CustomField5 are permitted. The request included a Name value for a custom field that was not one of the five allowed values. Set the custom field Name element to one of the allowed values.
INPUT_INVALID.CustomField.NotDefined A custom field cannot be null. The request included a null Value element for a custom field. Use a string value for the custom field.
INPUT_INVALID.CustomField.TooLong A custom field cannot be more than 50 characters long. The Value element in a custom field was too long. Retry the request with a custom field Value that is no more than 50 characters long.
INPUT_INVALID.CustomFieldValue.InvalidCharacter The value of custom field {custom field name} contains invalid character(s). The Value element in a custom field included one or more characters that are not allowed. Only use alphanumeric characters in custom field values, plus a few punctuation marks (no question marks).

Account Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.
REQUEST_FAILED.

Callback Registration Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.ServiceName.Invalid An invalid service name was provided, valid service names are "EnhancedConnectivityService", "PromoChanges", "ExternalProvisioningChanges", "DeviceUsage", "CarrierService", "ResumeTrackingNotification", "DevicePRLInformation", and "SMSDeliveryConfirmation". The service name in the request was not one of the allowed service names. Resend the request with one of the allowed service names.
INPUT_INVALID.ServiceName.IsEmpty The service name cannot be empty. The service name field in the request was empty. Resend the request with one of the allowed service names.
INPUT_INVALID.ServiceName.NotAlphanumeric The service name must contain only alphanumeric characters. The service name in the request contained punctuation or some other non-alphanumeric characters. Resend the request with one of the allowed service names.
INPUT_INVALID.Url.Invalid Please specify a properly formatted Url. The URL in the request did not include all required elements. Resend the request with the URL in the form protocol://path-to-your-callback-listening-service such as http://mycompany.com/CallbackListener.
REQUEST_FAILED.CallbackExists A callback service is already registered for this service. The account already has a URL registered for the service name included in the request. Use GetCallbackRegistrations to see a list of existing registrations for the account. To replace an existing registration, use UnregisterCallback and then RegisterCallback.
REQUEST_FAILED.Callback.NotRegistered No callback was registered for the Account and Service you specified. You attempted to unregister for a callback service, but the specified account does not have a URL registered for that service. Use GetCallbackRegistrations to see a list of existing registrations for the account.

Carrier Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.Account.MoveDeviceUnavailable This account is not enabled for Move Device The account that you are logged into is not enabled for Move Device Talk to your Verizon account representative about account changes required for MoveDevice.
INPUT_INVALID.AccountName An account name was not specified but is required for this action. The request did not included an account name. Specify an account name and retry the request.
INPUT_INVALID.AccountNotUnderSameCustomerProfile Both the current and new accounts must be under the same Customer profile The account that you are logged into and the account in the AccountName parameter are not in the same profile. Verify that the account in the AccountName parameter is in your customer profile, and then resend the request.
INPUT_INVALID.Activate.VodafoneServicePlan A service plan may not be specified when activating a Vodafone device. The ChangeDeviceState request to activate a Vodafone device contained a ServicePlan value. Do not set a ServicePlan value when activating a Vodafone device.
INPUT_INVALID.AddressIncomplete AddressLine1, City, State, Zip, and Country are required when providing address for PrimaryPlaceofUse. One or more of the following required values is missing: * AddressLine1 * City * State * Zip Resubmit the request with all of the required values.
INPUT_INVALID.BothLeadIdandPrimaryPlaceofUseProvided Include either the LeadId or PrimaryPlaceOfUse; not both. The ChangeDeviceState-Activate request contained values for both the Lead ID and PrimaryPlaceOfUse parameters. For VPP partner accounts, resubmit the activation request with a Lead ID. For non-VPP customers, resubmit the request with PrimaryPlaceOfUse values.
INPUT_INVALID.CarrierIpPoolNotFoundInNewAccount The carrier IP pool was not found in the new account. The new account does not have an IP Pool with the name specified in the CarrierIpPoolName parameter. Verify the name of the IP Pool, or leave CarrierIpPoolName blank to have the device IP address come from the default pool in the new account.
INVALID_INPUT.CarrierPoolNameOnNonB2BCarrier Carrier IP pool name can only be provided for B2B carriers. The request contained a value for CarrierIpPoolName. The CarrierIpPoolName parameter is only used with B2B carriers. Do not include it for other carriers.
INPUT_INVALID.Change4GOption.Invalid An invalid Change4GOption was provided. Valid Change4GOptions are "ChangeIMEI", "ChangeICCID", "ChangeIMEIANDICCID", "ChangeMSISDN", "3GTo4G", and "4GTo3G". The request did not contain one of the recognized Change4GOption values. Retry the request with a valid Change4GOption.
INPUT_INVALID.ChangeDeviceIdentifierToESNOrMEIDMissing An ESN or MEID was not specified for ChangeDeviceIdentiferTo but is required for this request. The 4Gto3G option requires either an ESN or an MEID value in the ChangeDeviceIdentifierTo parameter. The request did not contain either of those device identifier types. Retry the request with a valid ESN or MEID.
INPUT_INVALID.ChangeDeviceIdentifierToICCIDMissing An ICCID was not specified for ChangeDeviceIdentiferTo but is required for this request. The ChangeICCID and ChangeICCIDandIMEI options require a new ICCID value in the ChangeDeviceIdentifierTo parameter. Retry the request with a valid ICCID value.
INPUT_INVALID.ChangeDeviceIdentifierToIMEIMissing An IMEI was not specified for ChangeDeviceIdentiferTo but is required for this request. The ChangeIMEI and ChangeICCIDandIMEI options require a new IMEI value in the ChangeDeviceIdentifierTo parameter. Retry the request with a valid IMEI value.
INPUT_INVALID.ChangeDeviceIdentifierToMDNInfoMissing AssignNonGeoMDN, NPA-NXX, or Zip Code must be provided. The ChangeMSISDN request did not include parameters from which to derive a new MSISDN/MDN. Retry the request with a valid combination of values for AssignNonGeoMDN, MdnZipCode, and MdnNpaNxx.
INPUT_INVALID.ChangeDeviceIdentifierToMissing ChangeDeviceIdentifierTo was not specified but is required for this request. The request did not contain the ChangeDeviceIdentifierTo parameter, or the value was null. Retry the request with a valid ChangeDeviceIdentifierTo value.
INPUT_INVALID.Country Country can be either US or USA. The Country parameter does not contain US or USA. Resubmit the request with a valid Country parameter.
INPUT_INVALID.Device.EtfWaiver.NotDefined ETF waiver is required for deactivating retail devices. The request did not include a value for EtfWaiver. Set EtfWaiver to true or false.
INPUT_INVALID.Device.InvalidChangeDeviceIdentifierKind Cannot provide ChangeDeviceIdentifier Kind as IMEI, ICCID, IMSI or MSISDN or MDN. Valid values are ESN, MEID The ChangeDeviceIdentifier request included an invalid value for the Kind parameter. Set the Kind value to either ESN or MEID.
INPUT_INVALID.Device.Kind.InvalidWithSkuNumber Cannot provide SKU when specifying device type . The request contained a SkuNumber value and a device type other than ICCID. At this time, the SkuNumber parameter can only be used with ICCID identifiers. Remove the SkuNumber and then resend the request, or keep the SkuNumber and only include ICCID identifiers.
INPUT_INVALID.Device.Not3G The device is not a 3G device. The 3Gto4G option requires a 3G device in the DeviceIdentifiers parameter. The device specified is not a 3G device. Verify the current device ID and then resend the request.
INPUT_INVALID.Device.Not4G The device is not a 4G device. The device specified in the Change4GDeviceIdentifier request is not a 4G device. Use the ChangeDeviceIdentifier API for 2G/3G devices. If you need to change an identifier for a 4G device, verify the current device ID and then resend the request.
INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrIccid Cannot provide IMEI without ICCID, or vice versa, for activation request. An Activate request for a 4G device did not contain both the IMEI and ICCID identifiers. Resend the request with both the IMEI and the ICCID of the device, in that order.
INPUT_INVALID.Device.ReasonCode.NotDefined ReasonCode is required for deactivating retail devices. The Deactivate request was for a retail device that requires a ReasonCode for the deactivation. Set a value for ReasonCode and retry the request.
INPUT_INVALID.DeviceGroupNotFoundInNewAccount The Device Group was not found in the new account The new account does not have a device group with the name specified in the DeviceGroupName parameter. Verify the name of the device group, or leave DeviceGroupName blank to put the devices into the default device group in the new account.
INPUT_INVALID.DeviceState.Invalid The given device state is invalid, valid State values are Active, Active.Ready and Active.Test A Deactivate or Suspend request specified a device that is not in an Active state. Follow the best practice to determine a device's current state before sending a ChangeDeviceState request. Only Active devices can be deactivated or suspended.
INPUT_INVALID.FeatureCode.NotDefined A feature code cannot be blank. The FeatureCodesToAdd or FeatureCodesToRemove field did not contain a value. Specify the feature code that you want to add or remove, and then retry the request.
INPUT_INVALID.FeatureCodes.AddedAndRemoved Cannot both add and remove feature(s) {feature codes} at the same time. Can only do one or the other. The same feature code was included in the FeatureCodesToAdd and FeatureCodesToRemove values. Modify the request to either add or remove the feature code, and then retry the request.
INPUT_INVALID.FeatureCodesToAdd.Duplicate Feature(s) {feature codes} cannot be added more than once. A request to add feature codes included the same feature code more than once, or was for feature codes that are already enabled for the device. Verify that the feature codes that you want to add are not already enabled for the devices in the request. Retry the request, making sure that each feature code only appears once.
INPUT_INVALID.FeatureCodesToRemove.Duplicate Feature(s) {feature codes} cannot be removed more than once. |A request to remove feature codes included the same feature code more than once. Retry the request, making sure that each feature code only appears once.
INPUT_INVALID.InvalidAccountTypeForNpaNxxOrZip Telematics customer cannot select Mdn by Zip or Npa-Nxx
INPUT_INVALID.LeadIdSent The LeadId is not applicable to your account. The request included a value for LeadId, but the account does not use leads. Resubmit the request without the LeadId.
INPUT_INVALID.Lte.ChangeDeviceId Cannot set MEID or ESN for an LTE device. A ChangeDeviceIdentifier request was sent for a 4G LTE device. ChangeDeviceIdentifier can only be used for 2G/3G devices.
INPUT_INVALID.MaxRequestsExceeded Request contains more devices than the maximum allowable of 10000. A request was sent that included more than 10,000 devices. Send several requests instead of one request, each containing less than 10,000 devices.
INPUT_INVALID.MdnNpaNxx.Invalid The Mdn Npa-Nxx provided was not in a valid format; it must be exactly 6 numeric digits. The MdnNpaNxx field field did not contain the right number of digits, or contained other characters. Set the MdnNpaNxx value to a 6-digit value and retry the request.
INPUT_INVALID.MdnZipCode The Mdn Zip Code provided was not in a valid format. The MdnZipCode field did not contain the right number of digits, or contained other characters. Set the MdnZipCode value to a 5-digit value and retry the request.
INPUT_INVALID.MdnZipCodeMissing An MDN Zip code must be provided. The request did not include a value for the MdnZipCode field. Set the MdnZipCode field to the ZIP code from which the MDN will be derived, and retry the request.
INPUT_INVALID.MdnZipCodeRequiredForB2BNonGeo MDNZipCode is required to assign Non-Geo MDN for B2B carriers. The request did not include the required MdnZipCode value for a non-geo MDN change. Retry the request with an MdnZipCode value.
INPUT_INVALID.MissingCustomerName Both FirstName and LastName are required when providing PrimaryPlaceOfUse. One or more of the following required values is missing: * FirstName * LastName Resubmit the request with all required name values.
INPUT_INVALID.MoreThan2Deviceidentifiers ChangeDeviceIdentifierTo contained more than 2 device identifiers. Please provide only 2 device identifiers. The ChangeICCIDandIMEI option requires two new device identifier values in the ChangeDeviceIdentifierTo parameter, one for ICCID and one for IMEI. The request included more than those two identifiers. Provide one ChangeDeviceIdentifierTo parameter that contains a new ICCID and a new IMEI.
INPUT_INVALID.MultipleChangeDeviceidentifierTo ChangeDeviceIdentifierTo was specified more than once. Please provide a single device identifier. The request included more than one ChangeDeviceIdentifierTo parameter. Provide one and only one ChangeDeviceIdentifierTo parameter.
INPUT_INVALID.MultipleICCIDPresent ChangeDeviceIdentifierTo contains more than one ICCID. Please provide a single ICCID. The request included more than one ICCID in the ChangeDeviceIdentifierTo parameter. Retry the request with one and only one ICCID value in the ChangeDeviceIdentifierTo parameter.
INPUT_INVALID.MultipleIMEIPresent ChangeDeviceIdentifierTo contains more than one IMEI. Please provide a single IMEI. The request included more than one IMEI in the ChangeDeviceIdentifierTo parameter. Retry the request with one and only one IMEI value in the ChangeDeviceIdentifierTo parameter.
INPUT_INVALID.MultipleStateChanges {# actions} change state actions were specified. One and only one is expected. The ChangeDeviceState request included more than one state. Provide one and only one change state action element (e.g. cannot activate and suspend in the same request). Set all other change state action elements to null.
INPUT_INVALID.NoCarrierSpecified Specified Account has multiple carriers associated with it, carrier field may not be null. The Activate request did include not a CarrierName value. If you have access to multiple carriers, you must specify which carrier a device will have service with when activating it.
INPUT_INVALID.NoStateChanges No change state actions were specified. One and only one is expected. The ChangeDeviceState request did not include a device state. Set a non-null value for one of the change state action elements (e.g. activate, deactivate, etc…).
INPUT_INVALID.NpaNxxAndZipCodeProvided Cannot provide both MDN Npa-Nxx and Zip Code. The request included values for both the MdnNpaNxx and MdnZipCode fields. Set a value for either the MdnNpaNxx or the MdnZipCode and retry the request.
INVALID_INPUT.NPANXXRequiredForB2B NPANXX is Required to perform Change MDN for B2B carriers. ChangeDeviceIdentifier request for a device on a B2B carrier did not include a value for MdnNpaNxx. Set a value for the MdnNpaNxx parameter and retry the request.
INPUT_INVALID.PPUSent PPU is not applicable to your account. The request is for a VPP partner account and included values for PrimaryPlaceOfUse parameters. VPP partners should use LeadId instead of PrimaryPlaceOfUse when activating. Remove the PrimaryPlaceOfUse values and resend the request, including a LeadId if appropriate.
INPUT_INVALID.PublicIPRestriction.Invalid An invalid PublicIPRestriction was provided. Valid service names are "Restricted", "Unrestricted". A value other than "restricted" or "unrestricted" was used for the PublicIPRestriction parameter. For devices on the public network, use one of the allowed values or leave it empty to use the account default value.
INPUT_INVALID.ReasonCodes.ActionInvalid Action for getting reason codes is invalid. Only valid one is: Deactivate. You included a ReasonCode in a ChangeDeviceState request that was not a deactivate request. Retry the request without the ReasonCode.
INPUT_INVALID.ServicePlanMissing A service plan needs to be sent along with the request. The request did not specify a value for the ServicePlan field. Set the ServicePlan field to the service plan code that you want to assign to all specified devices, and then resend the request.
INPUT_INVALID.ServicePlanNotFoundInNewAccount The service plan was not found in the new account. The new account does not have a service plan with the code specified in the ServicePlan parameter, or no plan code was specified and the new account does not have a plan with the same code as the service plan in the current account. Put an existing service plan code from the new account in the ServicePlan parameter and resend the request.
INPUT_INVALID.SkuNumber.Invalid Invalid SKU provided. A valid SKU is an alphanumeric string with up to 20 characters The SkuNumber field contained unrecognized characters, or the value was too long. Use a SKU that is no more than 20 characters long and that only contains letters and numbers, and then resend the request.
INPUT_INVALID.TakeEffect.Value TakeEffect must be either null, BackDate, or FutureDate The TakeEffect parameter in the ChangeDeviceServicePlan request had an invalid value. Set the TakeEffect parameter to either null or "BackDate." No other values are allowed.
INPUT_INVALID.UpdateDeviceInformation.DeviceId A new ESN, MEID, MDN, NPA-NXX, or Zip Code must be given. The request did not include the required fields for changing the device identifier. The request must include a new ESN, MEID, or MDN, or an MdnNpaNxx or MdnZipCode from which to derive the new identifier.
INPUT_INVALID.UpdateDeviceInformation.
MdnInfoProvidedWithOtherDeviceIdentifier
Cannot provide new ESN or MEID to update if MDN, Zip Code or NPA-NXX are also provided. The request included some mutually-exclusive values. Do not include a value for ESN or MEID if you are setting values for MDN, MdnZipCode, or MdnNpaNxx.
REQUEST_FAILED.CarrierNotOnAccount The requested carrier is not a part of this account. The CarrierName given in the ChangeDeviceState request is not associated with the account. Verify the name of the carrier and retry the request. Note that if the account only has one carrier, you do not need to include the CarrierName field in the request.
REQUEST_FAILED.ReasonCodeNotFound Could not find reason code "{reason code}". The request contained an unrecognized value for ReasonCode. Provide a valid reason code that your organization has access to.
REQUEST_FAILED.ServicePlan.NotFound No Service Plan was found matching the code {service plan code}. The service plan specified in the request does not exist in the specified account. Verify the account name and service plan name, and retry the request.

Device Group Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.DeviceGroup.MaxDevicesExceeded Request contained more devices than the allowed maximum 200 devices per request. The request included too many devices for the API method. Send multiple requests, each one containing no more than 200 devices.
INPUT_INVALID.DeviceGroup.DeleteDefault Cannot delete the default device group. You attempted to delete the default device group, which is not allowed. The default device group automatically contains all devices. The group name can be changed, but the group cannot be deleted.
REQUEST_FAILED.DeviceGroup.Exists That group name already exists for this account. You attempted to add or update a device group and give it the same name as an existing device group. Retry your request using a different value for GroupName.
INPUT_INVALID.DeviceGroup.RepeatDeviceIdentifier A request may not contain the same device to both add and remove. The UpdateDeviceGroup request included the same device in both the DevicesToAdd and DevicesToRemove fields. Determine whether you want to add or remove the device from the group, and then retry the request.
INPUT_INVALID.DeviceGroup.InvalidFormat Device group name can only contain alphabet, number, space, underscore, or colon, and must start with an alphabet. The device group name contained an illegal character. Verify that the device group name only contains letter, numbers, underscores and colons, and that it starts with a letter.
INPUT_INVALID.DeviceGroup.TooLong Device group name cannot be more than 100 characters long. The device group name was too long. Use a shorter name and retry the request.
REQUEST_FAILED.InvalidDeviceIdentifier InValid device identifier(s) present in {devicesToAdd/devicesToRemove}. Device was not found for following DeviceIdentifier(s) :- [{list of device identifiers}] , in account {account name} The request included some device identifiers that don't belong to the account. Verify the list of device identifiers that you want to add or remove from the group, and then retry the request.
INPUT_INVALID.DeviceGroupNameRequired Device Group Name cannot be blank. There was no value for the GroupName field. Set a value for the GroupName field and retry the request.
REQUEST_FAILED.DeviceGroupNotFound Could not find device group "device group name". The device group given in the request does not exist in the account. Verify the account name and device group name, and then retry the request.

Device Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.DeviceStateFilter Invalid device state. Valid one is Preactive. You did not set the State element to "Preactive" in the AddDevices request. Set the value of the State element to "Preactive" and retry the request.
INPUT_INVALID.DeviceStateFilter Invalid device state filter The GetDeviceList request included an invalid value for DeviceStateFilter. Use one of the recognized device states for the DeviceStateFilter, such as "active" or "suspend." See GetDeviceList for the complete list.
INPUT_INVALID.NumberofDevices Only 200 or less devices are allowed at one time The request included more than 200 devices. Resend the request as multiple requests, each with no more than 200 devices.
INPUT_INVALID.AddDevices.Device.Kind.Invalid Device kind is not recognized as valid. Valid ones for adding a device are MEID, ESN, ICCID, or IMEI. The AddDevices or ChangeDeviceState - Activate request contained an MDN or MSISDN. Resend the request using the MEID or ESN for 3G devices, and both the IMEI and ICCID for 4G devices.
INPUT_INVALID.Device.OnlyOneProvidedOfImeiOrIccid Cannot provide IMEI without ICCID, or vice versa, for adding a device. An AddDevices request for a 4G device did not contain both the IMEI and ICCID identifiers. Resend the request with both the IMEI and the ICCID of the device, in that order.
INPUT_INVALID.Device.AssignToMultipleGroups Cannot assign a device to multiple groups. The AddDevices request contained more than one string in the DeviceGroupName element. Specify only one DeviceGroupName and retry the request.
REQUEST_FAILED.CallbackNotExists No DeviceUsage callback was registered for the Account You sent a GetAggregateDeviceUsage or GetRatedDeviceUsage request before registering for DeviceUsage callback messages. Device usage information is only returned in callback messages. Create a callback listener for DeviceUsage messages and then use RegisterCallback to tell the M2M Platform where to send those messages.
INPUT_INVALID.DateTime.InvalidRange The start date must come before the end date. The start date in the TimestampFilter is not earlier than the end date. Set correct values in the TimestampFilter and retry the request. INPUT_INVALID.DateTime.InvalidRange
INPUT_INVALID.DeviceInformationRequired Device Information is required. The AddDevices request did not include a DevicesToAdd element. Provide a non-null input for DevicesToAdd element in AddDevices request.

Enhanced Connectivity Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.SmsMessage.Null SmsMessage cannot be null. The SendSmsMessage request did not include a value for SmsMessage. Set the SmsMessage value to the string that you want to send to the devices, and then retry the request.
INPUT_INVALID.SmsMessage.TooLong An 8-bit SMS message cannot be more than 140 characters long. The SMS message was too long. Shorten the SMS message text to less than 140 characters (8-bit) and resend the request.
INPUT_INVALID.SmsMessage.TooLong A 7-bit SMS message cannot be more than 160 characters long. The SMS message was too long. Shorten the SMS message text to less than 160 characters (7-bit) and resend the request.
INPUT_INVALID.SmsMessage.AdjacentNullCharacters SmsMessage cannot contain two adjacent null characters. The SMS message contained two or more null characters next to each other. Remove adjacent null characters from your SMS message and retry the request.
INPUT_INVALID.SmsMessage.InvalidEncoding Please specify valid encoding. Valid Encoding types are 7-bit, 8-bit-ASCII, 8-bit-UTF-8 or 8-bit-DATA encoding. The value of the Encoding field was not recognized. Set the Encoding value to one of the allowed strings and then retry the request.
INPUT_INVALID.SmsMessage.InvalidEncodingStringPassed Please specify base64 encoded string for 8-bit SMS. The SmsMessage in the request was not encoded in base64. Convert messages that do not use the universal ASCII character set to base64 before sending them as SMS messages.
INPUT_INVALID.PreviousToken.InvalidFormat The PreviousToken was not a valid GUID. The PreviousToken value in the request was not in the correct format. Leave the PreviousToken element empty in the first request, and then use the Token value from the response in the next request.

Session Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.Login.BlankUsername Username cannot be blank. The username field was empty. Include your web services account username in the LogIn request.
INPUT_INVALID.Login.BlankPassword Password cannot be blank. The password field was empty. Include your web services account password in the LogIn request.
INPUT_INVALID.Login.Invalid Username or Password is incorrect. The username/password combination was invalid. Verify the credentials for your web services account and then send another LogIn request.
INPUT_INVALID.Login.UserLocked Your contact record is locked. The contact record has been locked due to too many invalid LogIn attempts. {{Contact Support}}
REQUEST_FAILED.User.RequiredRole This user does not have the Role required to access Unified Web Services. The web services user account does not have permission to create API sessions. {{Contact Support}}
INPUT_INVALID.Password.Incorrect Specified password is not correct. The request did not include the correct old (current) password. Retry the request, being sure to include the correct password.

State Service Errors

Error Code Error Message Occurs When Resolution
INPUT_INVALID.ServiceNameNotFound No Service Name was found matching the name "service_name" The service name specified in the request does not exist in the account. Verify the service name and retry the request.
INPUT_INVALID.StageStateNotFound No Stage State was found matching the name "state_name" The state name specified in the request does not exist in the account. Verify the state name and retry the request.