---
title: Apply Watermark and Footers on PDF API
slug: stamp-header-footer-on-pdf
url: https://apyhub.com/apyhub/service/stamp-header-footer-on-pdf
provider: ApyHub
categories: [File Manipulation]
auth: api_key
---

# Apply Watermark and Footers on PDF API

Add headers and footers to PDFs from a URL or file upload. Return a stamped PDF as a binary file or signed URL, with text or PNG image support.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/stamp/pdf/watermark-footers/url` | What it does Fetches a PDF from a URL, stamps a header and/or footer onto it, and returns a signed… | 200 |
| POST | `/stamp/pdf/watermark-footers/file` | What it does Uploads a PDF file and returns the stamped PDF as a binary file download. You provide… | 200 |
| POST | `/stamp/pdf/watermark-footers/file/url` | What it does Stamps a header and/or footer onto an uploaded PDF file and returns a JSON object cont… | 200 |
| POST | `/stamp/pdf/watermark-footers/url/file` | What it does Stamps a PDF fetched from a URL with header and/or footer content, then streams the pr… | 200 |

## About

## What it does
PDF Header Footer Stamping adds a header and footer to a PDF, either from a file URL or an uploaded PDF, and returns the stamped document as a binary file or a signed URL.

Send a source PDF as a URL or a binary upload, then provide header and footer content as text or PNG images. For text, you can set shared font size and opacity, or control header and footer settings separately with alignment, font size, and opacity. For image-based stamping, you can set image size for each slot. The API also supports alias fields like `header_text` and `footer_text`, and when both text and image are provided for the same slot, text takes priority.

Use this when you need to add document labels, page context, or branded marks to reports, statements, generated PDFs, or archived files before sharing them internally or with customers. Choose the URL-based endpoints when your workflow stores files remotely, or the download endpoints when you want the stamped PDF streamed back immediately.

## Usage

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