---
title: "Create an employee's I-9 authorization verification documents"
method: PUT
path: "/v1/employees/{employee_id}/i9_authorization/documents"
tags: ["I-9 Verification"]
---

# Create an employee's I-9 authorization verification documents

`PUT /v1/employees/{employee_id}/i9_authorization/documents`

## Request

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

An employee's I-9 verification documents are the documents an employee has provided the employer to verify their identity and authorization to work in the United States.

Use the [document options endpoint](ref:get-v1-employees-employee_id-i9_authorization-document_options) to get the possible document types and titles, which can vary depending on the employee's authorization status.

> 🚧 Every request must contain the complete list of documents for the Employee.
>
> Every request to this endpoint removes any previous verification document records for the employee.

### Related guides
- [I-9 employment verification](doc:i-9-employment-verification)

scope: `i9_authorizations:manage`

## Path parameters

- `employee_id` string, required

## Headers

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

## Request body

- I9AuthorizationDocumentsRequestBody: Request body for creating an employee's I-9 authorization verification documents.
  - `documents` object[], required: An array of I-9 verification documents. Every request must contain the complete list of documents for the employee, as previous records are replaced.
    - `document_type` string, required: The document type. Use the document options endpoint to get the possible values.
    - `document_title` string, required: The document title associated with the document type
    - `document_number` string: The document's document number
    - `expiration_date` string: The document's expiration date
    - `issuing_authority` string, required: The document's issuing authority

## Response `201`

Created

- I9AuthorizationDocument[]
  - `uuid` string, required: The UUID of the I-9 verification document
  - `document_type` string, required: The document's document type
  - `document_title` string, required: The document's document title
  - `expiration_date` string, nullable: The document's expiration date
  - `issuing_authority` string, required: The document's issuing authority

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[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)