> This page is for Docs. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://zuora.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server. # Authentication & Authorization errors > This reference provides a summary of authentication and authorization error codes, their messages, and suggested remedies for resolution. 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. |