Upload File

Upload a file attachment. Files are stored securely and can be linked to form submissions.

forms.edit
POST/v1/uploads

Send the file as multipart/form-data.

Example Request

curl
curl -X POST "https://proforms.io/api/v1/uploads" \
  -H "Authorization: Bearer pf_your_api_key" \
  -F "file=@document.pdf"

Response

200 OK
{
  "success": true,
  "data": {
    "id": "upl_abc123",
    "filename": "document.pdf",
    "mimeType": "application/pdf",
    "size": 245760,
    "url": "/api/v1/uploads/upl_abc123",
    "createdAt": "2026-02-17T11:00:00.000Z"
  }
}
ℹī¸
File uploads are typically handled automatically by form submissions with file fields. This endpoint is for programmatic uploads outside of the form flow.