post
https://api.fountain.com/v2/applicants//secure_documents/upload_and_link
Upload a secure file and link it to an applicant in one request.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Use this endpoint to upload a secure file and link it to an applicant in one request. It replaces the separate S3 upload and link_upload calls.
Send a multipart/form-data request with these fields:
| Field | Required | Description |
|---|---|---|
file | Yes | The file to upload. Allowed types are PDF, JPG, JPEG, PNG, GIF, HEIC, HEIF, WEBP, AVIF, DOC, DOCX, and TXT. The maximum size is 15 MB. |
key | Yes | Fountain file identifier, also called the data key. |
attribute_to_applicant | No | Set to true to show the applicant as the actor for the upload in the History panel. Omit it to attribute the upload to the caller. A Fountain One OAuth token attributes it to the Hire user with the token's email: your own user for a personal key, the integration's user for an integration key. A Hire API key, or a token whose email matches no Hire user, attributes it to the account owner. A request that sends both a Hire API key and a token is attributed by the Hire API key. |
Example request fields:
file=@/path/to/driver_license.pdf
key=driver_license
attribute_to_applicant=trueA successful request returns:
{ "uploaded": true }