GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference
These docs are for v2024-03-01. Click to read the latest docs for v2026-06-15.

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.

scope: i9_authorizations:manage

Path Params
string
required

The UUID of the employee

Body Params
documents
array of objects
required

An array of I-9 verification documents

documents*
Headers
string
enum
Defaults to 2024-03-01

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

Allowed:
Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json