Insert PDF Pages
Inserts selected pages from one or more source PDFs before or after specified pages in an original PDF and makes the modified PDF available for download.
Source Mapping: Provide one input_options item for each source_file, in the same order. When one source PDF is provided, input_options may be either a single object or a one-item array.
Endpoint
OAuth Scope
curl --request POST \
--url https://www.zohoapis.com/pdfeditor/api/v1/pdf/pages/insert \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: multipart/form-data' \
-F 'original_file=@file_path' \
-F 'source_file=appendix-a.pdf' \
-F 'source_file=appendix-b.pdf' \
-F 'input_options=[
{
"position": "after",
"page_number": "3",
"page_ranges": [
"1,3-5"
]
},
{
"position": "before",
"page_number": "8",
"page_ranges": [
"all"
]
}
]' \
-F 'output_settings={
"name": "quarterly-review-with-appendices.pdf"
}'Request Body
multipart/form-dataThe original PDF to modify, 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 with an area greater than 2,400 square inches. Its filename must not exceed 255 characters. Password-protected, corrupted, and empty PDFs are not supported. Supported formats: pdf.
The PDFs containing the pages to insert, uploaded directly or imported from publicly accessible URLs. Provide between 1 and 10 files. Each file must be no larger than 50 MB, contain no more than 400 pages, and have no page with an area greater than 2,400 square inches. Each filename must not exceed 255 characters. Password-protected, corrupted, and empty PDFs are not supported. Supported formats: pdf.
[
"appendix-a.pdf",
"appendix-b.pdf"
]The page-insertion instructions. Provide between 1 and 10 items.
[
{
"position": "after",
"page_number": "3",
"page_ranges": [
"1,3-5"
]
},
{
"position": "before",
"page_number": "8",
"page_ranges": [
"all"
]
}
]Show Sub-Attributes
Controls whether the selected source pages are inserted before or after the target page.
The one-based target page in the original PDF. The page must exist in the original PDF.
Up to 10 expressions selecting pages from the corresponding source PDF. Every numeric page must exist in that PDF. If omitted or empty, all source pages are inserted.
[
"1,3-5"
]Configures the modified PDF's filename.
{
"name": "quarterly-review-with-appendices.pdf"
}Show Sub-Attributes
The filename for the modified PDF. A .pdf extension is appended when the name does not already end with one.
// Note: payload contains multiple type attributes
// type: file
original_file = quarterly-review.pdf
// type: array[file]
source_file = [
"appendix-a.pdf",
"appendix-b.pdf"
]
// type: array
input_options = [
{
"position": "after",
"page_number": "3",
"page_ranges": [
"1,3-5"
]
},
{
"position": "before",
"page_number": "8",
"page_ranges": [
"all"
]
}
]
// type: object
output_settings = {
"name": "quarterly-review-with-appendices.pdf"
} {
"status": "inprogress",
"status_check_url": "https://www.zohoapis.com/pdfeditor/api/v1/pdf/pages/insert/job/4b97319d5c6a240ef86513782b7e1439fb92cd837ab864416fda91417e926bc8"
}
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.