API Errors
Zoho Writer APIs uses HTTP status codes to display the result of an API call. 2xx class codes are success codes, 4xx class codes occur when the information provided by the client is incorrect, and 5xx class codes indicate server side errors.
The HTTP status codes that are commonly used are listed below.
| Status Code | Description |
|---|---|
| 200 | OK |
| 201 | Created |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | URL Not Found |
| 405 | Method Not Allowed |
| 429 | Rate Limit Exceeded |
| 500 | Internal Error |
In addition to the status code, when a request fails, Zoho Writer APIs return an error in the following JSON format:
{
"error": {
"message": "<error_message>",
"documentation_url": "<documentation_url>",
"response_generated_time": "<timestamp_in_milliseconds>",
"request_url": "<invoked_api_request_url>",
"errorcode": "<error_code>"
}
}The error codes for each API operation are listed in the tables below.
General Errors
| Error Code | Description | Suggested Action |
|---|---|---|
| R2000 | The parameter values entered are not valid. | Enter supported values for the parameters and try again. |
| R2001 | Upload parameters are not configured properly. | Configure the upload parameters and try again. |
| R2003, R2009 | A mandatory parameter to perform this action is missing. | Add the required parameter and then try to perform the action. |
| R2004 | You have used the supported parameters multiple times (more than the limit). | Check if any parameters are added multiple times in the request and try again. |
| R2005 | The length of the parameter has exceeded the limit. | Reduce the length of the parameter and try again. |
| R2006 | The size of the request has exceeded the limit. | Check if the request size is within the limit and try again. |
| R2007, R2010 | You might have entered a wrong datatype for the parameters to perform this action. | Ensure you have the right datatype for parameters to perform this action. |
| R2008 | Request URL is not configured properly. | Check if the request URL is correct and try again. |
| R2011 | Unable to process JSON parameters or values. | Check if the input JSON parameters are properly sent along with the request and try again. |
| R3000 | This error occurs due to unexpected issues while invoking any Zoho Writer APIs. | Retry the request after a short interval. If the issue persists, contact support for further assistance. |
| R3049 | Non-native documents (PDF, DOCX, OTD, etc.) are not supported for document-related operations. | Try with a Writer document. To perform operations with non-native documents, use Zoho WorkDrive Rest APIs. |
| R3501 | Document management system has not been activated for your account. | Access the Onboard URL link provided in the response to activate DMS. |
| R3520 | The upload document size is more than 200 MB. | Upload a document with file size less than 200 MB and try again. |
| R3521 | The image count inside the document exceeds 200. | Delete some images from the document and try again. |
| R5000 | Unable to process your request due to an error. | This may be due to an internal error. Please try again after some time. |
| R5001 | Your Zoho account seems to be inactive. | Activate your Zoho account and try again. |
| R5002 | Your Zoho account registration has not been confirmed yet. | Confirm your Zoho account and try again. |
| R5003, R5004 | You have performed this action using a blocked IP or an IP which is not allowed. | Use an IP which is allowed (not blocked) to complete this action. |
| R5005 | Number of requests exceeds the allowed limit. | Try again after some time. |
| R5006 | The API method you used in your request is invalid. | Please use a valid method name and try again. |
| R5007 | You tried to access the URL using a different method instead of POST. | Use only POST method to access the URL. |
| R5008 | Antivirus host is not reachable to do a virus check. | This may be due to an internal error. Please try again after some time. |
| R5009 | You have XSS content in your parameters. | Verify the parameters and try again. |
| R5010 | You are not authorized to perform this operation. Permission denied. | Contact your administrator and obtain the access to perform the operation. |
| R5011 | Invalid authorization header provided. The access_token is either invalid or expired. | Create new access_token and try again. |
| R5012 | Your request has param types that are not supported in Writer API. | Enter valid parameter value and try again. |
| R5013 | Your API request is not authenticated. | Check and try with proper authentication. |
| R5014 | You are not having sufficient privilege to perform this operation. | Check with your organization administrator. |
| R5015 | You are trying to connect with an unknown domain. | Try again with a valid domain. |
| R5017 | Some oauth scopes are missing while generating oauthtoken to invoke the APIs. | Add the missing oauth scopes, regenerate the oauthtoken, and try again. |
| R5018 | This error occurs when you try to get the details of a document which is already trashed. | Try to get the details for an existing document. |
Create Document
| Error Code | Description | Suggested Action |
|---|---|---|
| R1000, R1001 | Invalid import URL | Unable to import the required file. This may occur when you're trying to import a file from an invalid web URL. |
| R1002 | Unsupported file extension | The file you're trying to import has an unsupported extension. |
| R1007 | File size exceeded | The size of the file you're trying to upload has exceeded the maximum file size supported by Writer. |
| R1008 | Unsupported content type | The file you're trying to import has an unsupported content-type. |
| R1009 | Virus detected | The file you're trying to import via the web URL seems to contain a virus. |
| R1010 | Document conversion failure | The file that you're trying to upload could not be converted or imported in Writer. |
| R1013 | Uploaded document is corrupted | The file which you are trying to upload is corrupted. |
| R1014 | Password not provided | The document imported seems to be password protected and the password is not provided. |
| R1015 | Invalid password | The document imported seems to be password protected and the provided password is incorrect. |
| R1016 | File format not supported | The file format (MS Word 97 or older) of the uploaded file is not supported. |
| R2005 | Filename is too large | The length of the filename provided exceeded the allowed limit. |
Copy Document
| Error Code | Description | Suggested Action |
|---|---|---|
| R3040 | Unable to copy/duplicate the document. | Try again in a while. |
| R3042 | Unable to copy document as there is no permission for that particular folder. | Ensure you have sufficient permissions to save files to the target folder. |
| R3049 | Copy restricted for non-native Writer documents. | Try again with a valid Writer resource. |
| R3054 | Unable to copy document as download permission is restricted. | Contact your team admin to enable downloads. |
| R4706 | Copy restricted as the document is in draft state. | Mark the document as ready before copying. |
| R5010 | You are not authorized to perform this operation. Permission denied. | You do not have permission to perform this action. |
List Documents
| Error Code | Description | Suggested Action |
|---|---|---|
| R2000 | The value specified for the params is invalid or you have used the params that are not configured properly. | Please set the value with respect to the available limit and try again. |
| R2010 | The data type of the parameter is invalid. | Set a valid param data type in your API request and try again. |
| R3003 | Unable to fetch the list of documents. | This may be due to an internal error. Please try again after |
Download Document
| Error Code | Description | Suggested Action |
|---|---|---|
| R3001 | The user does not have sufficient privileges to download the document. This may be due to an organization policy restriction. | Please contact your organization administrator. |
| R3002 | Unable to download the document. This may be due to an internal server error. | Please try again after some time. |
| R5010 | The user might not have enough permission to download the document. | Downloading could be restricted if the user does not have access to the document or has only read-only permissions. Change the permissions and try again. |
Convert Document
| Error Code | Description | Suggested Action |
|---|---|---|
| R2009 | You have missed the mandatory parameter in your API request. | Please make sure you provide the document format to be converted in your API request and try again. |
Update Document Metadata
| Error Code | Description | Suggested Action |
|---|---|---|
| R3009 | Unable to update the document description. | This might be due to an internal error. Please try again after some time. |
| R3010 | Unable to make the document as favourite. | This might be due to an internal error. Please try again after some time. |
| R3011 | Unable to mark the document as final. | This might be due to an internal error. Please try again after some time. |
| R3012 | Unable to lock the document. | This might be due to an internal error. Please try again after some time. |
| R3013 | Unable to unlock the document. | This might be due to an internal error. Please try again after some time. |
| R3014 | While trying to lock a document which is already locked, it throws this error code. | Please confirm if the document is already locked. |
| R3015 | While trying to unlock a document which is not locked yet, this error code will be thrown. | Please confirm if the document is locked and then try to unlock it. |
| R3016 | While trying to unlock a document which is locked by a different user, it throws this error code. | Please check with the admin of the document to get access to it. |
| R3017 | Unable to complete the lock operation. | This might be due to an internal error. Please try again after some time. |
| R3027 | Unable to remove the document from favourite list. | This might be due to an internal error. Please try again after some time. |
| R3028 | Unable to revert the document which is marked as final to edit more. | This might be due to an internal error. Please try again after some time. |
| R3029 | Unable to rename the document. | This might be due to an internal error. Please try again after some time. |
| R3301 | Your request will not be processed at the moment due to a temporary server error. | This might be due to an internal error. Please try again after some time. |
| R3303 | An error while trying to publish your post. | This might be due to an internal error. Please try again after some time. |
| R3305 | Unable to publish your post at the moment due to a temporary server error. | This might be due to an internal error. Please try again after some time. |
| R3306 | Unable to publish your post as there was an error connecting to your account. | This might be due to an internal error. Please try again after some time. |
| R3307 | A temporary error while scheduling your post. | This might be due to an internal error. Please try again after some time. |
| R3308 | Your request will not be processed at the moment due to a temporary server error. | This might be due to an internal error. Please try again after some time. |
Document Operations
| Error Code | Description | Suggested Action |
|---|---|---|
| R3005 | Unable to delete the document. | This might be due to an internal error. Please try again after some time. |
| R3008 | Unable to retrieve the document details. | This might be due to an internal error. Please try again after some time. |
| R3018 | Unable to move the document to trash. | This might be due to an internal error. Please try again after some time. |
| R3032 | Unable to restore the document. | This might be due to an internal error. Please try again after some time. |
| R3039 | This error occurs while you are trying to delete or move a document to trash when the trashing process is already taking place in the backend. | Please try again after the backend trashing process is completed. |
| R3047 | This error occurs when you are trying to trash a document which is already moved to trash. | (No explicit suggested action provided) |
| R3048 | This error occurs when you try to delete the document permanently before trashing it. | Please trash the document before deleting it permanently. |
| R5010 | User does not have enough permission or access to delete the document. | Please make sure you have provided your own document. If it is a document from the team folder, please contact the admin/owner of the document to provide the required permission and try again. |
Templates
| Error Code | Description | Suggested Action |
|---|---|---|
| R3033 | Limit value provided to retrieve templates list has exceeded the supported count. | You can only fetch a maximum of 100 templates at a time. Please provide a value below the supported limit and try again. |
| R3500 | Problem in listing the available templates. | Try again later. If the issue persists, contact support. |
| R3502 | Problem in creating a new template. | Try again later. If the issue persists, contact support. |
| R3503 | Problem in duplicating a template. | Try again later. If the issue persists, contact support. |
| R3504 | Unable to retrieve the template details. | Try again later. If the issue persists, contact support. |
| R3505 | Org templates are not supported for your account. | Org templates are supported only for Zoho Workdrive users. Please upgrade to Workdrive to access this feature. |
| R3507 | Problem in deleting the template. | Try again later. If the issue persists, contact support. |
| R3512 | Problem in listing the public templates. | Try again later. If the issue persists, contact support. |
| R3513 | Problem in renaming the template. | Try again later. If the issue persists, contact support. |
| R3514 | Problem in updating the template description. | Try again later. If the issue persists, contact support. |
| R3515 | Problem in updating the template properties. | Try again later. If the issue persists, contact support. |
Merge
| Error Code | Description | Suggested Action |
|---|---|---|
| R6000 | Internal server error occurred while processing merge request. | Contact Zoho Writer support at support@zohowriter.com. |
| R6001 | Merge data is not provided. | Provide valid merge data and try again. |
| R6002 | Document to be merged with data is not provided. | Provide a valid document file and try again. |
| R6003 | Recipient email parameter is not passed or email address is not saved in settings. | Pass the 'recipient_email' parameter or save the email address in settings. |
| R6004 | Signer data parameter is not provided or signer details are not saved in settings. | Provide valid signer details or save them in settings. |
| R6006 | Signer info provided is invalid (e.g., 'field_id' not given). | Verify and provide complete signer info with all required fields. |
| R6007 | Unique attachment parameter value is passed incorrectly. | Verify and pass the unique attachment info correctly. |
| R6008 | In-person signer info is not passed. | Provide the required in-person signer information. |
| R6009 | Recipient's email address does not belong to your organization's domain. | Use an email address from your organization's domain. |
| R6010 | Verification info key value is passed incorrectly. | Verify and pass the verification info with correct values. |
| R6011 | Maximum daily merge limit has been reached for your account. | Try again after 24 hours or contact support for higher limits. |
| R6012 | Maximum daily email send limit has been reached. | Try again after 24 hours or contact support for higher limits. |
| R6013 | Monthly credit points limit for merge operations has been reached. | Purchase additional credit points to continue merging. |
| R6014 | Merge data count has exceeded the limit (max 5 for normal sign flow). | Reduce merge data count to within the allowed limit. |
| R6016 | Document content exceeds 1,500,000 characters limit. | Reduce document size or split into multiple documents. |
| R6017 | Daily test mode merge limit has been reached. | Try again after specified hours or upgrade to production. |
| R6021 | Not authorized to save file in the specified folder. | Verify you have the required permissions for the folder. |
| R6022 | Not authorized to use the specified 'From' email address. | Use an authorized 'From' email address. |
| R6031 | Required scope is missing for uploading merged file to folder. | Add appropriate Docs or WorkDrive scope to your configuration. |
| R6033 | Account is not synced with the Sign service. | Sync your account with Sign service and try again. |
| R6041 | Error occurred while merging file with provided merge data. | Verify merge data is valid and properly formatted, then try again. |
| R6044 | 'id' field is missing from merge data for CRM templates. | Add the 'id' field with CRM record ID in merge data (e.g., {"name": "John", "email": "john@example.com", "id": "1234567789"}). |
| R6053 | Replacing existing files is not supported for Zoho Docs users. | Upgrade to WorkDrive to enable file replacement feature. |
| R6054 | Custom function is not configured in the merge template. | Configure the required custom function in your template. |
| R6069 | Upload document size exceeds 200 MB limit. | Reduce document size to below 200 MB and try again. |
| R6070 | Document contains more than 200 images. | Delete some images from the document to reduce count below 200. |
| R6099 | Zoho Docs folder ID was passed to store merged documents (Zoho Docs is deprecated). | Use a WorkDrive folder ID instead to store merged documents. |
Send Document for Signing
| Error Code | Description | Suggested Action |
|---|---|---|
| R8001 | Mandatory parameters missing | Provide required parameters: recipient email address and signed_document_name |
| R8002 | Unable to create a new sign request | Retry the operation after checking request parameters for server issues or invalid configuration |
| R8003 | Invalid account | Create an account in Zoho Sign service and try again |
| R8004, R8103 | Zoho Sign credits exhausted | Upgrade your license to send more documents for sign |
| R8005 | Unable to generate OAuth Tokens | Check configured OAuth scopes or access the Sign configuration dialog from UI before using the API |
| R8006 | Signer name not found | Provide a valid in-person signer name |
| R8007 | Signer email address not found | Provide a valid in-person signer email address or choose a different verification type |
| R8008 | Verification code not found | Provide a valid verification code for offline signer verification |
| R8009 | Verification code limit exceeded | Provide a verification code that is exactly 6 characters long |
| R8010 | Recipient country code not found | Provide a valid country code for phone-based verification or delivery |
| R8011 | Recipient phone number not found | Provide a valid recipient phone number |
| R8012 | Invalid recipient email address | Use a valid email address of an active organization member for in-person signing |
| R8014 | Insufficient permission | Upgrade your plan to support the Approver role |
| R8015 | Recipients email addresses are empty | Provide valid email addresses for all recipients |
| R8016 | Credit points limit has exceeded | Purchase more credit points to continue merge operations |
| R8017 | Daily limit has reached | Fill the limit extension form to increase daily API limits |
| R8019 | OAuth information not found | Open the sign configuration dialog once and try using the API again |
| R8020 | Phone number differs | Use the same phone number for both recipient verification and delivery |
| R8021 | Country code differs | Use the same country code for both verification and delivery details |
| R8022 | Zoho Sign account does not exist | Create a Zoho Sign account and try again |
| R8101 | Unable to upload the document | Check upload settings and try again |
| R8102 | No signer fields for the recipients | Add at least one signer field for each recipient in the document |
| R8104 | Invalid Zoho Sign org id | Provide a valid organization ID |
Combine
| Error Code | Description | Suggested Action |
|---|---|---|
| R6013 | This error occurs when the credit points limit has been reached for your organization. | Purchase more credit points to continue. |
| R7500 | This may be due to an internal error. | Please try again after some time. |
| R7501 | This error is thrown when the input PDF files are not passed. | Check and try again with input files. |
Publish
| Error Code | Description | Suggested Action |
|---|---|---|
| R3019 | Unable to unpublish the document from the web. | This might be due to an internal error. Please try again after some time. |
| R3020 | Unable to unpublish the document within the organization. | This might be due to an internal error. Please try again after some time. |
| R3021 | Attempting to unpublish a document that has not been published. | Publish the document first, then unpublish it. |
| R3022 | Unable to publish the document externally. | This might be due to an internal error. Please try again after some time. |
| R3023 | Unable to publish the document within the organization. | This might be due to an internal error. Please try again after some time. |
| R5002 | Your Zoho account has not been confirmed yet. | Confirm your account and try again. |
| R5014 | User does not have access or sufficient privilege to perform the operation. | Contact your organization administrator to obtain access or change permission settings. |
Translate Document
| Error Code | Description | Suggested Action |
|---|---|---|
| R9101 | Document exceeds the 20,000-character limit. | Reduce document size to within 20,000 characters and retry. |
| R9102 | Insufficient permission to translate the document. | Contact your administrator to request translation permissions. |
| R9103 | File format is not supported for translation. | Use a supported document format and retry. |
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.