Authentication & Authorization errors
This reference provides a summary of authentication and authorization error codes, their messages, and suggested remedies for resolution.
Error code range: 70002001–70002030
| Code | Error Code | Error Message | Possible Remedy |
|---|---|---|---|
| 70002001 | ZUORA_ENTITY_ID_MISSING | An Entity ID is required. Please provide a valid Zuora Entity ID. | Include a valid Zuora-Entity-Id header in your API request. If you are unsure of your Entity ID, check the Zuora tenant settings. |
| 70002002 | ZUORA_USER_ID_MISSING | A User ID is required. Please provide a valid Zuora User ID. | Include a valid User ID in the request. Ensure your API credentials are correctly configured. |
| 70002003 | MULTIPLE_ENTITY_IDS_FOUND | Multiple Entity IDs were found. Please specify which one to use. | Your account has multiple entities. Specify the correct Entity ID in the Zuora-Entity-Id header. |
| 70002004 | TENANT_MEDIATION_NOT_ENABLED | Usage metering is not enabled for your account. Please contact support to enable it. | Contact Zuora support or your account representative to enable the Usage Metering feature for your tenant. |
| 70002005 | RATE_LIMITED | You have exceeded the request limit. Please wait a moment and try again. | Reduce the frequency of API calls. Implement exponential backoff and retry logic. If you consistently hit rate limits, contact support to discuss increasing your limit. |
| 70002006 | UNAUTHORIZED | You do not have permission to perform this action. | Verify your API credentials and ensure your user role has the necessary permissions. Check the Zuora platform settings for role-based access control. |
| 70002010 | INVALID_BIGDECIMAL_VALUE | The value “[Value]” is not a valid decimal number. | Ensure numeric fields contain valid decimal values without letters, special characters, or incorrect separators. |
| 70002011 | INVALID_DATE_STRING | The value “[Value]” is not a valid date. | Use a supported date format (e.g., 2024-01-15 or 2024-01-15T10:30:00Z). |
| 70002012 | TIMEZONE_MISSING | A timezone is required. | Provide a valid timezone (e.g., UTC, America/New_York) in the request or meter configuration. |
| 70002013 | INVALID_JSON_TEXT | The input must be valid JSON. | Validate your JSON input using a JSON validator. Common issues include trailing commas, unquoted keys, or mismatched brackets. |
| 70002014 | INVALID_XML_TEXT | The input must be valid XML. | Validate your XML input. Ensure proper tag nesting, closing tags, and encoding declarations. |
| 70002015 | INVALID_PAGE | Page number must be greater than 0. | Set the page parameter to 1 or higher. |
| 70002016 | INVALID_PAGE_SIZE | Page size must be greater than 0. | Set the pageSize parameter to 1 or higher. |
| 70002017 | PAGE_SIZE_TOO_LARGE | Page size must be [Maximum Page Size] or fewer. | Reduce the pageSize parameter to the maximum allowed value shown in the error. |
| 70002018 | EMPTY_CONNECTION_NAME | A connection name is required. | Provide a valid connection name in the request. |
| 70002019 | CONNECTION_NOT_FOUND | The connection “[Connection Name]” was not found. If you have not completed onboarding, please contact support. | Verify the connection name for typos. If this is a new setup, complete the onboarding process with Zuora support to provision the connection. |
| 70002020 | INVALID_TIME_UNIT | The time unit “[Time Unit]” is not valid. | Use a supported time unit (e.g., SECONDS, MINUTES, HOURS, DAYS). |
| 70002021 | PARAMETER_REQUIRED | The parameter “[Parameter Name]” is required. | Include the missing parameter in your request. |
| 70002022 | PARAMETER_IS_EMPTY | The parameter “[Parameter Name]” must not be empty. | Provide a non-empty value for the specified parameter. |
| 70002023 | PARAMETER_INVALID | The parameter “[Parameter Name]” is invalid. | Check the parameter value against the API documentation for allowed values and formats. |
| 70002024 | FIELD_REQUIRED | The field “[Field Name]” is required. | Add the missing field to your request body. |
| 70002025 | CONCURRENT_REQUEST | Another request is currently in progress. Please wait a moment and try again. | Wait for the current operation to complete before retrying. This typically occurs during meter activation, deactivation, or deployment. |