Add Watermark to PDF
Stamps a watermark onto every page of a PDF and makes the watermarked file available for download.
Watermark Type: When input_options.type is text, provide input_options.text_info. When it is image, provide input_options.image_info and image_file.
Endpoint
OAuth Scope
curl --request POST \
--url https://www.zohoapis.com/pdfeditor/api/v1/pdf/watermark \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: multipart/form-data' \
-F 'file=@file_path' \
-F 'input_options={
"type": "text",
"text_info": {
"content": "CONFIDENTIAL",
"rotation": "Diagonal",
"font_color": "rgb(204,0,0)",
"font_family": "Helvetica",
"font_size": 36
}
}' \
-F 'output_settings={
"name": "quarterly-report-watermarked"
}' \
-F 'image_file=@file_path'Request Body
multipart/form-dataThe source PDF to watermark, 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. Supported formats: pdf.
Configures the watermark to apply.
{
"type": "text",
"text_info": {
"content": "CONFIDENTIAL",
"rotation": "Diagonal",
"font_color": "rgb(204,0,0)",
"font_family": "Helvetica",
"font_size": 36
}
}Show Sub-Attributes
The watermark variant to apply: text-based or image-based.
Text watermark settings.
{
"content": "CONFIDENTIAL",
"rotation": "Diagonal",
"font_color": "rgb(204,0,0)",
"font_family": "Helvetica",
"font_size": 36
}Show Sub-Attributes
The text to stamp on each page.
The orientation of the watermark text on the page.
The color of the watermark text. Accepts rgb(r,g,b), a six-digit hex #RRGGBB, a three-digit hex #RGB, or a CSS named color.
The font face for the watermark text.
The font size for the watermark text, in points.
Image watermark settings.
{
"opacity": 0.5,
"height": 100,
"width": 150
}Show Sub-Attributes
Controls the transparency of the watermark image.
The rendered height of the watermark image.
The rendered width of the watermark image.
Configures the watermarked PDF's filename.
{
"name": "quarterly-report-watermarked"
}Show Sub-Attributes
The name to assign to the watermarked PDF.
The image to use as the watermark, uploaded directly or imported from a publicly accessible URL. The file must be no larger than 10 MB, and its pixel area must not exceed 144,000,000 pixels. Supported formats: jpg, png.
// Note: payload contains multiple type attributes
// type: file
file = quarterly-report.pdf
// type: object
input_options = {
"type": "text",
"text_info": {
"content": "CONFIDENTIAL",
"rotation": "Diagonal",
"font_color": "rgb(204,0,0)",
"font_family": "Helvetica",
"font_size": 36
}
}
// type: object
output_settings = {
"name": "quarterly-report-watermarked"
}
// type: file
image_file = company-logo.png {
"status": "inprogress",
"status_check_url": "https://www.zohoapis.com/pdfeditor/api/v1/pdf/watermark/job/qE8Vn4M2kP7sR9xW"
}
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.