How to turn a document into a URL
Documents move through customer portals, support workflows, approval systems, and internal tools. FilePost gives each uploaded document a stable URL that can be saved alongside your application data.
There is no separate SDK for Word, Excel, PowerPoint, or text files. Send the document as multipart form data, keep the filename private by default, and use the JSON response in the next step of your workflow.
Upload document files with FilePost
Use the authenticated FilePost upload API for document files. The endpoint returns a JSON object containing the public URL, file ID, size, content type, and filename mode.
curl -X POST https://upload.filepost.dev/v1/upload \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@contract.docx"
Example response
{
"url": "https://cdn.filepost.dev/file/…",
"file_id": "a1b2c3d4e5f6",
"name": "contract.docx",
"size": 84210,
"content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
}
What to do with the returned URL
Store the returned URL with the document record or pass it to a notification, CRM, or approval workflow.
<a href="https://cdn.filepost.dev/file/…" download>Download document</a>
Good uses for document to URL
- Customer-uploaded documents
- Reports and exports from internal tools
- Document links in email and workflow systems
Know the boundary
FilePost does not edit, preview, convert, or scan documents. Add your own validation, conversion, or malware-scanning step when the product requires it.
For the complete request and response contract, see the FilePost API documentation. You can also test the flow with the interactive upload on the homepage.