Add Attachments to PDF
Attaches one or more files to a PDF as embedded attachments, and makes the modified PDF available for download.
Endpoint
OAuth Scope
curl --request POST \
--url https://www.zohoapis.com/pdfeditor/api/v1/pdf/attachment/add \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: multipart/form-data' \
-F 'file=@file_path' \
-F 'attach_files=signed-form.pdf' \
-F 'attach_files=id-photo.jpg' \
-F 'password=OpenSesame123'Request Body
multipart/form-dataThe source PDF to attach files to, uploaded directly or imported from a publicly accessible URL. 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. Its filename must not exceed 255 characters. Supported formats: pdf.
One to 10 files to embed as attachments, uploaded directly or imported from publicly accessible URLs. Each file must be no larger than 20 MB and its filename must not exceed 255 characters. Each file's own filename is used as its attachment name. Supported formats: pdf, jpg, jpeg, png.
[
"signed-form.pdf",
"id-photo.jpg"
]The password to unlock the source file, if it is password-protected. Not used for attach_files.
// Note: payload contains multiple type attributes
// type: file
file = quarterly-review.pdf
// type: array[file]
attach_files = [
"signed-form.pdf",
"id-photo.jpg"
]
// type: string
password = OpenSesame123 {
"status": "inprogress",
"status_check_url": "https://www.zohoapis.com/pdfeditor/api/v1/pdf/attachment/add/job/3f65c7592a741d98e46bf310cbe678f574a1d51fce306a8d9b6430217e538acd"
}
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.