Add to PDF

Add to PDF is a REST API tool that inserts new content into a PDF, including images and file attachments. Place images with precision without disrupting underlying PDF content, and attach any file format to a PDF.

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

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.

Build your solution

You have document processing problems, we have Solutions. Explore the many ways pdfRest can align your documents with your business objectives.

Browse all Solutions

Integrate pdfRest with Microsoft Power Automate

Add Generated Barcodes to PDF Forms

Create an e-Invoicing PDF Workflow for Regulatory Compliance

Integrate PDF API Tools with Salesforce Apex Code

Control your Backend with pdfRest API Toolkit Self-Hosted

Why is pdfRest the best API to add image or attachment to PDF?

pdfRest offers the best solution for adding images or attachments to PDF documents, because it supports precise image positioning, variable data printing, and attaching any file.

Precise Image Positioning

The Add to PDF API Tool makes it easy to add an image 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.

Add to PDF supports a wide range of the most common graphic image formats with high-quality preservation of color accuracy and resolution:

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

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.

Attach Any File

With the Add to PDF API Tool you can easily add any file as an attachment to a PDF. There are many reasons why you may need to attach files to a PDF, including providing supplementary information, facilitating collaboration, preserving backups.

Many e-invoicing standards from around the world have requirements for specific file formats to be attached to PDF documents. For example, ZUGFeRD is a German standard for e-invoicing based on the PDF/A-3 format with attached XML files. Simalarly, the Saudi Arabia FATOORAH standard also requires XML files to be attached to PDF/A-3 documents.

Check out other videos

Start from Code Examples

First, you'll need an API Key - to:
- Stay anonymous with a Guest API Key for 10 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

Need more help?

Start with a Tutorial for step-by-step guidance

How to Add Attachments to PDF Files in .NET with C#

How to Add Attachments to PDF Files with JavaScript in NodeJS

How to Add Attachments to PDF Files with PHP

How to Add Attachments to PDF Files with Python

How to Add Images to PDF Files in .NET with C#

How to Add Images to PDF Files with Java

How to Add Images to PDF Files with JavaScript in NodeJS

How to Add Images to PDF Files with PHP

How to Add Images to PDF Files with Python

1 of 2 pages (10 items)

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.

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

Compatible with the /pdf-with-added-image endpoint.

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

Compatible with the /pdf-with-added-image endpoint.

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.

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.

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.

File to Attach

Compatible with the /pdf-with-added-attachment endpoint.

The file_to_attach parameter lets you upload a file to pdfRest's processing server to attach to an input PDF. Select any kind of file to add to PDF.

Id to Attach

Compatible with the /pdf-with-added-attachment endpoint.

The id_to_attach 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.

id_to_attach also lets you attach a file that was uploaded previously to an input PDF document.

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