---
title: "Update employee onboarding documents config"
method: PUT
path: "/v1/employees/{employee_id}/onboarding_documents_config"
tags: ["Employees"]
---

# Update employee onboarding documents config

`PUT /v1/employees/{employee_id}/onboarding_documents_config`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/employees/{employee_id}/onboarding_documents_config`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/employees/:employee_id/onboarding_documents_config/put.ts> (a function with typed inputs; its response is checked against the schema)

Indicate whether to include the Form I-9 for an employee during the onboarding process.
If included, the employee will be prompted to complete Form I-9 as part of their onboarding.

## Related guides
- [Employee onboarding](doc:employee-onboarding)

scope: `employees:manage`

## Path parameters

- `employee_id` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- EmployeeOnboardingDocumentsConfigRequest: Request body for updating an employee's onboarding documents configuration.
  - `i9_document` boolean: Whether to include Form I-9 for this employee during onboarding. When true, the employee will be prompted to complete Form I-9 as part of their onboarding.

## Response `200`

Success

- EmployeeOnboardingDocument: Configuration for which onboarding documents (e.g. Form I-9) are required for an employee during onboarding.
  - `uuid` string, nullable: The UUID of the onboarding documents config record. Null when no config has been saved yet.
  - `i9_document` boolean: Whether to include Form I-9 for this employee during onboarding. When true, the employee will be prompted to complete Form I-9 as part of their onboarding.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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