Add blank pages exactly where you need them to prepare PDFs for printing, signing, or note-taking.
Add blank pages exactly where you need them β at the beginning or end of a document, or between specific pages.
Automatically insert blank pages into PDF files in Google Drive using our Zapier integration. Itβs the easiest way to structure documents at scale.
Create space for handwritten notes, separators, or section dividers to improve readability and organization in lengthy documents like contracts, workbooks, or training manuals.
This example will insert a new US letter-sized page after the first page of the document.
Try it out in three steps
document.pdf to your project folder.result.pdf to see the output.curl -X POST https://api.nutrient.io/build \ -H "Authorization: Bearer your_api_key_here" \ -o result.pdf \ --fail \ -F document=@document.pdf \ -F instructions='{ "parts": [ { "file": "document", "pages": { "start": 0, "end": 0 } }, { "page": "new", "pageCount": 1, "layout": { "size": "Letter" } }, { "file": "document", "pages": { "start": 1, "end": -1 } } ] }'curl -X POST https://api.nutrient.io/build ^ -H "Authorization: Bearer your_api_key_here" ^ -o result.pdf ^ --fail ^ -F document=@document.pdf ^ -F instructions="{\"parts\": [{\"file\": \"document\", \"pages\": {\"start\": 0, \"end\": 0}}, {\"page\": \"new\", \"pageCount\": 1, \"layout\": {\"size\": \"Letter\"}}, {\"file\": \"document\", \"pages\": {\"start\": 1, \"end\": -1}}]}"package com.example.pspdfkit;
import java.io.File;import java.io.IOException;import java.nio.file.FileSystems;import java.nio.file.Files;import java.nio.file.StandardCopyOption;
import org.json.JSONArray;import org.json.JSONObject;
import okhttp3.MediaType;import okhttp3.MultipartBody;import okhttp3.OkHttpClient;import okhttp3.Request;import okhttp3.RequestBody;import okhttp3.Response;
public final class PspdfkitApiExample { public static void main(final String[] args) throws IOException { final RequestBody body = new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart( "document", "document.pdf", RequestBody.create( MediaType.parse("application/pdf"), new File("document.pdf") ) ) .addFormDataPart( "instructions", new JSONObject() .put("parts", new JSONArray() .put(new JSONObject() .put("file", "document") .put("pages", new JSONObject() .put("start", 0) .put("end", 0) ) ) .put(new JSONObject() .put("page", "new") .put("pageCount", 1) .put("layout", new JSONObject() .put("size", "Letter") ) ) .put(new JSONObject() .put("file", "document") .put("pages", new JSONObject() .put("start", 1) .put("end", -1) ) ) ).toString() ) .build();
final Request request = new Request.Builder() .url("https://api.nutrient.io/build") .method("POST", body) .addHeader("Authorization", "Bearer your_api_key_here") .build();
final OkHttpClient client = new OkHttpClient() .newBuilder() .build();
final Response response = client.newCall(request).execute();
if (response.isSuccessful()) { Files.copy( response.body().byteStream(), FileSystems.getDefault().getPath("result.pdf"), StandardCopyOption.REPLACE_EXISTING ); } else { // Handle the error throw new IOException(response.body().string()); } }}using System;using System.IO;using System.Net;using RestSharp;
namespace PspdfkitApiDemo{ class Program { static void Main(string[] args) { var client = new RestClient("https://api.nutrient.io/build");
var request = new RestRequest(Method.POST) .AddHeader("Authorization", "Bearer your_api_key_here") .AddFile("document", "document.pdf") .AddParameter("instructions", new JsonObject { ["parts"] = new JsonArray { new JsonObject { ["file"] = "document", ["pages"] = new JsonObject { ["start"] = 0, ["end"] = 0 } }, new JsonObject { ["page"] = "new", ["pageCount"] = 1, ["layout"] = new JsonObject { ["size"] = "Letter" } }, new JsonObject { ["file"] = "document", ["pages"] = new JsonObject { ["start"] = 1, ["end"] = -1 } } } }.ToString());
request.AdvancedResponseWriter = (responseStream, response) => { if (response.StatusCode == HttpStatusCode.OK) { using (responseStream) { using var outputFileWriter = File.OpenWrite("result.pdf"); responseStream.CopyTo(outputFileWriter); } } else { var responseStreamReader = new StreamReader(responseStream); Console.Write(responseStreamReader.ReadToEnd()); } };
client.Execute(request); } }}// This code requires Node.js. Do not run this code directly in a web browser.
const axios = require('axios')const FormData = require('form-data')const fs = require('fs')
const formData = new FormData()formData.append('instructions', JSON.stringify({ parts: [ { file: "document", pages: { start: 0, end: 0 } }, { page: "new", pageCount: 1, layout: { size: "Letter" } }, { file: "document", pages: { start: 1, end: -1 } } ]}))formData.append('document', fs.createReadStream('document.pdf'))
;(async () => { try { const response = await axios.post('https://api.nutrient.io/build', formData, { headers: formData.getHeaders({ 'Authorization': 'Bearer your_api_key_here' }), responseType: "stream" })
response.data.pipe(fs.createWriteStream("result.pdf")) } catch (e) { const errorString = await streamToString(e.response.data) console.log(errorString) }})()
function streamToString(stream) { const chunks = [] return new Promise((resolve, reject) => { stream.on("data", (chunk) => chunks.push(Buffer.from(chunk))) stream.on("error", (err) => reject(err)) stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf8"))) })}import requestsimport json
response = requests.request( 'POST', 'https://api.nutrient.io/build', headers = { 'Authorization': 'Bearer your_api_key_here' }, files = { 'document': open('document.pdf', 'rb') }, data = { 'instructions': json.dumps({ 'parts': [ { 'file': 'document', 'pages': { 'start': 0, 'end': 0 } }, { 'page': 'new', 'pageCount': 1, 'layout': { 'size': 'Letter' } }, { 'file': 'document', 'pages': { 'start': 1, 'end': -1 } } ] }) }, stream = True)
if response.ok: with open('result.pdf', 'wb') as fd: for chunk in response.iter_content(chunk_size=8096): fd.write(chunk)else: print(response.text) exit()<?php
$FileHandle = fopen('result.pdf', 'w+');
$curl = curl_init();
curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.nutrient.io/build', CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_POSTFIELDS => array( 'instructions' => '{ "parts": [ { "file": "document", "pages": { "start": 0, "end": 0 } }, { "page": "new", "pageCount": 1, "layout": { "size": "Letter" } }, { "file": "document", "pages": { "start": 1, "end": -1 } } ] }', 'document' => new CURLFILE('document.pdf') ), CURLOPT_HTTPHEADER => array( 'Authorization: Bearer your_api_key_here' ), CURLOPT_FILE => $FileHandle,));
$response = curl_exec($curl);
curl_close($curl);
fclose($FileHandle);POST https://api.nutrient.io/build HTTP/1.1Content-Type: multipart/form-data; boundary=--customboundaryAuthorization: Bearer your_api_key_here
--customboundaryContent-Disposition: form-data; name="instructions"Content-Type: application/json
{ "parts": [ { "file": "document", "pages": { "start": 0, "end": 0 } }, { "page": "new", "pageCount": 1, "layout": { "size": "Letter" } }, { "file": "document", "pages": { "start": 1, "end": -1 } } ]}--customboundaryContent-Disposition: form-data; name="document"; filename="document.pdf"Content-Type: application/pdf
(document data)--customboundary--Start now
Start building with DWS Processor API in minutes β no payment information required.
Already have an account? Sign in β
Most common next steps
After validating blank-page insertion, continue to merge PDF if the workflow needs to combine entire documents rather than insert blank pages, getting started for API key setup, the Postman collection for the fastest first request, Processor API pricing for credits, or the Processor API overview for broader DWS evaluation of add-page, blank-page, and document-preparation workflows.
No input or resulting documents are stored on our infrastructure. All files are deleted as soon as a request finishes. Alternatively, check out our self-hosted product.
All communication between your application and Nutrient is done via HTTPS to ensure your data is encrypted when itβs sent to us.
All payments are handled by Paddle. Nutrient DWS Processor API never has direct access to any of your payment data.
Create an account to get your DWS Processor API key and start making API calls.