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.

Parameters

Api-Key

Required Parameters

POST

/pdf-with-added-image

curl -X POST "https://api.pdfrest.com/pdf-with-added-image" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  curl -X POST "https://api.pdfrest.com/pdf-with-added-image" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  

Response

The response for your API Call will display here.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)

Check out other videos

Start from Code Examples

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
Choose your programming language
Copy and paste the code to your project
Update Api-Key field with your unique API Key
Update file with the local path to your input
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 Collection

curl -X POST "https://api.pdfrest.com/pdf-with-added-image" \
  -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"curl -X POST "https://api.pdfrest.com/pdf-with-added-image" \
  -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

File

The file parameter allows you to select a local PDF file to be uploaded to pdfRest’s processing server. Use file to upload a PDF that you would like to insert an image into.

Id

The id parameter allows you to submit a resource ID generated by one of our API Tools. Each of our API Tools assigns a unique resource ID to your output file(s), allowing you to chain requests together without having to download intermediate files between requests.

For example, you can submit the output ID you receive from our Convert to PDF tool to insert an image file into your new PDF.

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

Image Id

The image_id parameter allows you to submit a resource ID generated by one of our API Tools. Each of our API Tools assigns a unique resource ID to your file(s), allowing you to chain requests together without having to download intermediate files between requests.

For example, you can submit the output ID you receive from the /jpg endpoint of our PDF to Images tool to insert the generated image into an input PDF file.

The following file formats are accepted:

.gif
.jpg/.jpeg
.png
.tif/.tiff

Output

The output parameter lets you set a filename (without extension) for your compressed PDF.

x

The x parameter lets you set the horizontal position of the image in PDF units (1 PDF unit = 1/72 inch).

By default, the origin of the PDF coordinate system is in the lower-left corner of the document, so the x parameter indicates the position relative to the left edge of the page. If the PDF has an offset origin, this can affect the position at which the image will be inserted.

y

The y parameter lets you set the vertical position of the image in PDF units (1 PDF unit = 1/72 inch).

By default, the origin of the PDF coordinate system is in the lower-left corner of the document, so the y parameter indicates the position relative to the bottom edge of the page. If the PDF has an offset origin, this can affect the position at which the image will be inserted.

Page

The page parameter lets you set the page of the input PDF into which the image will be inserted. Specify a page number within the number of pages in the input PDF.

See Documentation

Generate a self-service API Key now!

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

Compare Plans

Logged in as

Log In

Recover password

Let's get started

Generate a dedicated API Key by creating an account or starting as a guest.

Create an Account

OR

Be our Guest

Account information

Which primary language will you use to call the pdfRest service?

Which API Tool(s) are you interested in?

What problems are you hoping to solve with pdfRest?

How did you hear about pdfRest?