---
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`

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](https://docs.gusto.com/embedded-payroll/docs/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.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)