add to pdf logo

Add to PDF

Add to PDF is a REST API tool that inserts new content, such as an image, into a PDF document at a precise location on a selected page without disrupting the underlying PDF content.

A bubbling flask with code brackets inside
Try Now with API Lab

Start right from your browser - upload files, choose parameters, generate code, and send API Calls directly from API Lab!  

to receive your free API Key.
Required Parameters
curl -X POST "" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
The response for your API Call will display here.
Once you've sent your POST request and received a valid response, you can download your output file using the output URL.

Get the best with pdfRest

Precise Positioning

The Add to PDF API Tool makes it easy to add new content to a PDF exactly where you need it.  Select the PDF page and set the x and y coordinates to precisely position your new content using standard PDF units and the native PDF coordinate system.  With exactly 72 PDF units per inch, you can easily fine-tune your placement.

Support Variable Data Printing

Quickly and easily create custom PDFs ready to print uniquely for each customer, user, or recipient of your document.  Automate and streamline your workflow for adding variable data to template PDFs, including personalized logos, photos, and user information.  Add to PDF "stamps" content right where you need it without modifying the underlying content of the PDF.  Whether you need to add your customers' business logos to their invoices or addresses onto envelopes, the Add to PDF API Tool makes it easy.

Robust Image Support

The Add to PDF API Tool supports a wide range of the most common graphic image formats. This one, simple tool allows you to add any of the following types of images to a PDF, with high-quality preservation of color accuracy and resolution:

  • JPEG (.jpg, .jpeg)
  • TIF (.tif, .tiff)
  • PNG (.png)
  • GIF (.gif)

Start from Code Examples

  1. First, you'll need an API Key - to:
    • Stay anonymous with a Guest API Key for 50 free API Calls
    • Sign up for an upgraded API Key with unlimited, continuous service
  2. Choose your programming language
  3. Copy and paste the code to your project
  4. Update Api-Key field with your unique API Key
  5. Update file with the local path to your input
  6. Run this code to send an API Call
See more code examples in our
GitHub repository
Try pdfRest with just a few clicks
Download our Postman Postman Collection
curl -X POST "" \
  -H "Accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -F "file=@../Sample_Input/ducky.pdf" \
  -F "image_file=@../Sample_Input/strawberries.jpg" \
  -F "output=example_out" \
  -F "x=10" \
  -F "y=10" \
  -F "page=1"

Customize Your Solution

Image File

The image_file parameter allows you to select a local image to be uploaded to pdfRest’s processing server.

The following file formats are accepted:
  • .gif
  • .jpg/.jpeg
  • .png
  • .tif/.tiff
Generate a self-service API Key now!

Create your FREE API Key to start processing PDFs in seconds, only possible with pdfRest.

Compare Plans