---
title: "Upload a PDF file for signing"
method: POST
path: "/files"
tags: ["files"]
---

# Upload a PDF file for signing

`POST /files`

## Request

- Base URL: `https://docs-api.formify.eu/v1`
- URL: `https://docs-api.formify.eu/v1/files`
- Auth: OAuth 2 (authorization code, authorization URL `https://docs-api.formify.eu/v1/oauth/authorize`, token URL `https://docs-api.formify.eu/v1/oauth/token`)

Uploads a PDF file to Formify, making it available for creating document signature requests via the `POST /docs` endpoint.

### Requirements
- **File Format**: Only PDF files are supported.
- **File Size**: Maximum allowed file size is **50 MB**.
- **Unlocked PDFs Only**: The file must not be password-protected or locked in any way. Locked files cannot be processed.
- **No Pre-Signed Documents**: The PDF must not contain digital signatures from other services, as these will be removed, invalidating the document's signature integrity.
- **Signature Field Handling**: If the uploaded document contains existing signature fields (interactive PDF form fields of type `signature`), these will be removed automatically. New signature fields, fully compatible with the Formify signing process, must be added to the document instead. This ensures that all signature fields function seamlessly within the Formify platform.
By ensuring these requirements are met, you can use the uploaded file to create a document signature request seamlessly.

## Response `201`

File uploaded successfully

- object
  - `fileId` string, uuid: The unique identifier of the uploaded file

## Other responses

- `400`: Invalid request parameters or issues with the file
- `401`: Unauthorized - Missing or invalid access token.
- `403`: Forbidden - Access to the file is denied
- `500`: Internal server error

---

[API](https://skmtc.dev/formify/apis/formify-api.md) · [All operations](https://skmtc.dev/formify/apis/formify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formify/apis/formify-api/revisions/571c4c0d4f4f?raw)