---
title: "Create an employee document"
method: POST
path: "/employees/{employee_id}/documents"
tags: ["Employees"]
---

# Create an employee document

`POST /employees/{employee_id}/documents`

## Request

- Base URL: `https://app.peopleforce.io/api/public/v3`
- URL: `https://app.peopleforce.io/api/public/v3/employees/{employee_id}/documents`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/peopleforce/apis/company-api/docs/employees/:employee_id/documents/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a document for an employee

## Request body `multipart/form-data`

- object
  - `document_folder_id` integer, required
  - `name` string, required
  - `document` union: A parameter that can accept either a binary string or a base64-encoded string is a versatile input option that can accommodate different data formats
    - string, binary
    - string
  - `url` string, uri: Required is creating an external link to a document

## Response `200`

OK

- object
  - `data` EmployeeDocument
    - `id` integer, required
    - `name` string
    - `type` 'file' | 'link'
    - `document_folder_id` integer, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `url` string, required
    - `expires_at` string, date-time: Returned if document is a file type. Files expire and isn’t available via returned url at this time.

---

[API](https://skmtc.dev/peopleforce/apis/company-api.md) - [All operations](https://skmtc.dev/peopleforce/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peopleforce/apis/company-api/revisions/ff612e61a4c3?raw)