File upload API

Upload files directly to storage with one-time URLs, then reference them in a submission.

formclick.min.js handles uploads for you. If you build your own client (a mobile app, a custom uploader), follow the same three steps.

File uploads are available on the Pro and Business plans. Each file can be up to 5 MB.

1. Request an upload URL

Terminal

curl -X POST https://api.formclick.io/preupload \
  -H "Content-Type: application/json" \
  -d '{
    "accessKey": "YOUR_ACCESS_KEY",
    "fileName": "jane-smith-cv.pdf",
    "contentType": "application/pdf",
    "fileSize": 248133
  }'

JSON

{
  "success": true,
  "fileId": "f_9c1e…",
  "key": "uploads/…/jane-smith-cv.pdf",
  "uploadUrl": "https://…"
}

The upload URL is valid for 5 minutes and works once.

2. Upload the file

Send the raw file bytes with PUT, using the same Content-Type you declared.

JavaScript

await fetch(uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': file.type },
  body: file,
});

3. Submit with the file reference

JSON

{
  "access_key": "YOUR_ACCESS_KEY",
  "name": "Jane Smith",
  "resume": {
    "id": "f_9c1e…",
    "key": "uploads/…/jane-smith-cv.pdf",
    "name": "jane-smith-cv.pdf",
    "size": 248133,
    "type": "application/pdf"
  }
}

For a field with several files, send a list of these objects.

Allowed file types

Group	Types
Images	JPEG, PNG, GIF, WebP, SVG, TIFF
Documents	PDF, Word (`.doc`, `.docx`), Excel (`.xls`, `.xlsx`), PowerPoint (`.ppt`, `.pptx`)
Text & data	Plain text, CSV
Archives	ZIP

Still need help? Contact support or email support@formclick.io.