---
title: Apply Watermark and Footers on PDF API
slug: add-header-footer-to-pdf
url: https://apyverse.com/apyhub/service/add-header-footer-to-pdf
provider: ApyHub
categories: [File Manipulation]
tags: [pdf, header-footer, document-processing, pdf-manipulation, page-numbering]
auth: api_key
---

# Apply Watermark and Footers on PDF API

Add header and footer text or PNG images to a PDF from a file upload or URL. Returns a modified PDF as binary or an S3 URL.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `stamp/pdf/watermark-footers/file` | What it does Uploads a PDF, adds the requested header and/or footer content, and returns the modifi… | 200 |
| POST | `stamp/pdf/watermark-footers/file/url` | What it does Adds a header and/or footer to an uploaded PDF and returns the URL of the processed fi… | 200 |
| POST | `stamp/pdf/watermark-footers/url/file` | What it does Converts a PDF from a publicly accessible URL by adding a header and/or footer, then r… | 200 |
| POST | `stamp/pdf/watermark-footers/url` | What it does Adds a header and/or footer to a PDF referenced by URL, then returns a URL to the proc… | 200 |

## About

## What it does
PDF Header Footer adds text or PNG images to the top and bottom of a PDF, then returns the modified file as a download link or a binary response.

Send a PDF as a file upload or a publicly accessible URL. You can add `header_text` or `footer_text`, and the footer text can include `{page}` as a placeholder for the page number. If you prefer branded output, provide `header_image` / `footer_image` for file uploads or `header_image_url` / `footer_image_url` for URL-based jobs. Header and footer alignment can be set to `left`, `center`, or `right`.

Use PDF Header Footer when you need to stamp internal documents with a confidentiality notice, add page numbers to reports, or apply consistent branding across exported PDFs. The service supports both upload-to-download and upload-to-S3 URL workflows, so you can fit it into batch processing as well as direct user-facing document tools.

The output is either a binary PDF or an object containing a `url`, depending on the endpoint you call.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/apyhub/service/add-header-footer-to-pdf