---
title: "Upload your own PDF (≤ 25 MB, ≤ 30 pages) → a detected draft to review. 30 uploads an hour."
method: POST
path: "/api/v1/custom-forms"
tags: ["Custom forms"]
---

# Upload your own PDF (≤ 25 MB, ≤ 30 pages) → a detected draft to review. 30 uploads an hour.

`POST /api/v1/custom-forms`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/custom-forms`
- Auth: HTTP bearer

## Query parameters

- `name` string
- `refine` '1'
- `keep` 'all'

## Response `201`

The draft: id, status, page_count, field_count, fields, check { error, warning }

## Other responses

- `400`: Not a readable PDF
- `403`: Custom form limit reached

---

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