Upload PDF
Uploads a PDF, stores it in Zoho WorkDrive, and prepares it for editing in Zoho PDF Editor.
PDF Input: Provide at least one of file or url. If both are provided, the multipart item processed last is used.
Endpoint
OAuth Scope
curl --request POST \
--url https://www.zohoapis.com/pdfeditor/api/v1/upload \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: multipart/form-data' \
-F 'file=@file_path' \
-F 'url=https://zylker.com/documents/quarterly-review.pdf' \
-F 'folder_id=qpz9g646b2ddd954247b3988165bc17c156fe' \
-F 'filename=Quarterly Review.pdf' \
-F 'password=S3cur3P@ss'Request Body
multipart/form-dataThe PDF file to upload. The file must be no larger than 50 MB, contain no more than 400 pages, and have no page larger than 2,400 square inches. Supported formats: pdf.
A publicly accessible URL from which to import the PDF. The file must be no larger than 50 MB, contain no more than 400 pages, and have no page larger than 2,400 square inches.
The alphanumeric ID of the WorkDrive folder in which to store the PDF. If omitted, the authenticated user's default folder is used. The caller must have permission to create files in the folder.
The name to assign to the uploaded PDF. If omitted or blank, the source file's name is used.
The password to unlock the source PDF, if it is password-protected.
// Note: payload contains multiple type attributes
// type: file
file = quarterly-review.pdf
// type: string(uri)
url = https://zylker.com/documents/quarterly-review.pdf
// type: string
folder_id = qpz9g646b2ddd954247b3988165bc17c156fe
// type: string
filename = Quarterly Review.pdf
// type: string
password = S3cur3P@ss {
"created_time": 1767268800000,
"role": "OWNER",
"owner_id": "950162",
"parent_folder_id": "qpz9g646b2ddd954247b3988165bc17c156fe",
"open_url": "https://pdf.zoho.com/pdfeditor/open/6yc4z4f557db79e9f446ca37f5702c8b901f6",
"is_favourite": false,
"document_id": "6yc4z4f557db79e9f446ca37f5702c8b901f6",
"created_by": "Amelia",
"version": "1.0",
"document_name": "Quarterly Review.pdf",
"modified_time": 1767268800000,
"preview_url": "https://workdrive.zoho.com/file/6yc4z4f557db79e9f446ca37f5702c8b901f6",
"lastmodified_by": [
{
"email_id": "amelia@zylker.com",
"user_id": "950162",
"display_name": "Amelia",
"profile_photo": "https://contacts.zoho.com/file?t=user&ID=950162&fs=thumb"
}
],
"status": "Success"
}
Rate Limits
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.