Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
I-9 Verification

Create an employee's I-9 authorization verification documents

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

scope: i9_authorizations:manage

put/v1/employees/{employee_id}/i9_authorization/documents

Path parameters

employee_idstring required

The UUID of the employee

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

Example request

{
  "documents": [
    {
      "document_type": "us_passport",
      "document_title": "US Passport",
      "document_number": "F12345678",
      "expiration_date": "2026-01-01",
      "issuing_authority": "USA"
    }
  ]
}

Response

Created

uuidstring required

The UUID of the I-9 verification document

document_typestring required

The document's document type

document_titlestring required

The document's document title

expiration_datestring nullable

The document's expiration date

issuing_authoritystring required

The document's issuing authority