Upload a Document
Upload a PDF or DOCX file to create a document.
Upload a Document
POST
/api/v1/documentsUpload via multipart/form-data
Required scope:write:documents
Documents must be uploaded as multipart/form-data. Supported formats: PDF and DOCX. Maximum size: 50 MB.
Form Data Fields
| Name | Type | Description |
|---|---|---|
| file | File | The PDF or DOCX file to upload |
| title | string | Document title. Defaults to the filename. |
curl -X POST https://formalingo.com/api/v1/documents \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-F "file=@/path/to/contract.pdf" \
-F "title=Service Agreement"Response201
{
"success": true,
"data": {
"id": "doc-uuid",
"title": "Service Agreement",
"status": "draft",
"originalFilename": "contract.pdf",
"fileType": "pdf",
"originalUrl": "https://storage.url/...",
"pageCount": null,
"createdAt": "2026-02-25T10:00:00.000Z",
"updatedAt": "2026-02-25T10:00:00.000Z"
}
}Next steps
After uploading:
- Place fields on the document pages
- Create signer roles
- Create a submission with your signers