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

# Apply Footers on PDF API

Add text or PNG headers and footers to a PDF from a file or URL. Returns a modified PDF or an S3 URL for invoices, reports, and branded documents.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/stamp/pdf/footers/file` | What it does Uploads a PDF file and returns a modified PDF with a header and/or footer added. You c… | 100 |
| POST | `/stamp/pdf/footers/file/url` | What it does Uploads a PDF file and returns a URL to the processed PDF with a header and/or footer… | 100 |
| POST | `/stamp/pdf/footers/url/file` | What it does Adds a header and/or footer to a PDF fetched from a public URL, then returns the modif… | 100 |
| POST | `/stamp/pdf/footers/url` | What it does Adds a header and/or footer to a PDF referenced by URL, then returns a JSON object con… | 100 |

## About

## What it does
PDF Header Footer adds text or PNG images to the top and bottom of a PDF, then returns the updated file or a downloadable URL.

Send a PDF and choose one of four input styles: upload a file or pass a public PDF URL, then receive either a binary download or a JSON response with a `url`. You can set `header_text` or `footer_text`, use `{page}` in footer text to print the page number, or provide `header_image` and `footer_image` / `header_image_url` and `footer_image_url` for image-based branding. Alignment is configurable for both header and footer with `left`, `center`, or `right`.

Use PDF Header Footer when you need to stamp invoices, add page numbers, mark internal documents with labels like `CONFIDENTIAL`, or place a logo on exported reports. The service is built for simple document post-processing: you provide the source PDF and the header/footer content, and it returns a modified PDF ready to store, send, or download.

The `/file/download` and `/url/download` endpoints return the modified PDF directly. The `/file/url` and `/url/url` endpoints return an S3 URL in a `url` field, which is useful when your workflow needs a persisted output location instead of a file stream.

## Usage

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