Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
I-9 Verification

Employer sign an employee's Form I-9

Sign an employee's Form I-9 as an employer. Once the form is signed, the employee's I-9 authorization is considered complete and cannot be modified.

Prerequisites

Before calling this endpoint:

  1. The employee must have a completed I-9 authorization
  2. The employee must have signed the Form I-9
  3. I-9 verification documents must be submitted

Related guides

scope: i9_authorizations:manage

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

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.

x-gusto-client-ipstring

Optional header to supply the IP address. This can be used to supply the IP address for signature endpoints instead of the signed_by_ip_address parameter.

Request body

signature_textstring required

The signature

signer_titlestring required

The signer's job title

signed_by_ip_addressstring

The IP address of the signatory who signed the form. Both IPv4 AND IPv6 are supported. You must provide the IP address with either this parameter OR you can leave out this parameter and set the IP address in the request header using the x-gusto-client-ip header instead.

agreeboolean required

Whether you agree to sign electronically

additional_infostring

Any additional notes

alt_procedureboolean

Whether an alternative procedure authorized by DHS to examine documents was used

Response

Success

uuidstring required

The UUID of the I-9 authorization

form_uuidstring nullable

The UUID of the Form associated with this I-9 authorization. Use this with "Employee Forms" API endpoints.

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

authorization_status'citizen' | 'noncitizen' | 'permanent_resident' | 'alien' required

The employee's authorization status

document_type'uscis_alien_registration_number' | 'form_i94' | 'foreign_passport' nullable

The document's document type

has_document_numberboolean nullable

Whether or not a document_number exists for this document.

expiration_datestring nullable

The document's expiration date

countrystring nullable

The document's country of issuance

employer_signedboolean required

Whether the employer has signed the Form I-9

employee_signedboolean required

Whether the employee has signed the Form I-9

additional_infostring nullable

Any additional notes

alt_procedureboolean nullable

Whether an alternative procedure authorized by DHS to examine documents was used