Action on I-9

Embedded Administrator experience

Now that you've generated the employee's I-9 access, administrators can track employees' I-9 progress and take action on Forms I-9. Generate the administrator embedded URL to integrate in your platform.

Generate Administrator Access

To generate the token that launches the administrator embedded experience, call the /employers/{employerId}/admins/{adminId}/generateToken endpoint, setting the employer ID and administrator ID in the path parameters.

A successful call will return the URI and access token within the token object to launch the administrator embedded experience.

Sample Request

curl --location 'https://api.symmetry.com/i9/v1/employers/01971d41-b29d-75cf-a308-123456/admins/01972152-29ab-78f4-93ce-123456a0/generateToken' \
--header 'Authorization:Bearer  ••••••'

Sample Response

{
  "token": {
    "embeddedUri": "https://symmetry.workbright.com/sign_in_with_token?token=123456789",
    "token": "123456789"
  }
}

Response Elements

Below are the fields returned in the token object.

ElementTypeDescription
embeddedUriA fully constructed URL to embed within your platform to access the employee's I-9 session. This link embeds the token as a query parameter and can be used to launch the employee's embedded experience.
tokenToken used to authenticate the employee into the embedded experience. Valid for 30 minutes.

Action on Forms I-9

There are several reasons why an administrator would need to take action on an employee's I-9:

  • Completing Section 2
  • Generating reports based on completion rates
  • Intervening on E-Verify cases
  • Acknowledging document verification results
  • Reviewing upcoming document expiration dates or receipts

Jump to top