Skip to content
/
Create a new Form I-9

Create a new Form I-9

Request

Creates a new Form I-9 resource. This resource allows the creation of a single Form I-9 in each request.

Security
basic_auth
Bodyapplication/jsonrequired
candidate_idstringrequired

Candidate resource Id.

Example:"3de7e278beb24d14a3785e2dd02cca49"
start_datestring, (date)required

Candidate start date.

Example:"2026-04-29"
worksite_idstring, (uuid)required

Worksite resource Id. Retrieve valid Ids from List existing Worksites.

Example:"25a06fdc-c2f0-4bb2-b455-1666c1608c6e"
workflow_typestringrequired

Workflow type.

For additional insights into workflow types, please consider reviewing the Form I-9 definitions.

Enum:"remote_section_1_only""employee_appointment"
Example:"remote_section_1_only"
curl -i -X POST \
  -u '<username>:<password>' \
  https://docs.checkr.com/_mock/apis/openapi/v2/i9/forms_i9 \
  -H 'Content-Type: application/json' \
  -d '{
    "candidate_id": "3de7e278beb24d14a3785e2dd02cca49",
    "start_date": "2026-04-29",
    "worksite_id": "25a06fdc-c2f0-4bb2-b455-1666c1608c6e",
    "workflow_type": "remote_section_1_only"
  }'

Responses

Form I-9 details

Bodyapplication/json
idstring, (uuid)

ID of the resource

Example:"9adab19c-c8a8-44f1-a2fc-a8bd614d5c93"
candidate_idstring

ID of the Checkr candidate the Form I-9 belongs to.

Example:"3de7e278beb24d14a3785e2dd02cca49"
full_namestring

Full name of the candidate.

Example:"John Doe"
emailstring

Candidate email address.

Example:"john.doe@example.com"
statusstring

Current status of the Form I-9 / E-Verify process.

Enum:"Section 1 in progress""Section 2 in progress""E-Verify in progress""Action required""Authorized""Unauthorized"
Example:"Section 1 in progress"
start_datestring, (date)

Candidate start date (ISO 8601).

Example:"2026-04-29"
worksite_idstring, (uuid)

Worksite resource Id.

Example:"25a06fdc-c2f0-4bb2-b455-1666c1608c6e"
worksite_namestring

Name of the Worksite associated with the Form I-9.

Example:"Headquarters"
workflow_typestring

Type of workflow.

Enum:"remote_section_1_only""employee_appointment"
Example:"remote_section_1_only"
apply_urlstring, (uri)

Link the candidate uses to complete Section 1. Share this link with the candidate if they did not receive the invitation email.

Example:"https://apply.checkr.com/apply/context/9adab19c-c8a8-44f1-a2fc-a8bd614d5c93?welcome=false"
created_atstring, (date-time)

Form I-9 date of creation.

Example:"2026-04-29T16:21:11Z"
Response
{
  "id": "9adab19c-c8a8-44f1-a2fc-a8bd614d5c93",
  "candidate_id": "3de7e278beb24d14a3785e2dd02cca49",
  "full_name": "John Doe",
  "email": "john.doe@example.com",
  "status": "Section 1 in progress",
  "start_date": "2026-04-29",
  "worksite_id": "25a06fdc-c2f0-4bb2-b455-1666c1608c6e",
  "worksite_name": "Headquarters",
  "workflow_type": "remote_section_1_only",
  "apply_url": "https://apply.checkr.com/apply/context/9adab19c-c8a8-44f1-a2fc-a8bd614d5c93?welcome=false",
  "created_at": "2026-04-29T16:21:11Z"
}
© Checkr, Inc.