Action on I-9 - Symmetry Docs

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 GET endpoint, setting the employer ID and administrator ID in the path parameters. A successful call will return the embeddedUri 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"
  }
}

Response elements

Below are the fields returned in the token object.

Element	Type	Description
`embeddedUri`	string	A fully constructed URL to embed within your platform to access the administrator’s session. This link embeds the token as a query parameter and can be used to launch the administrator embedded experience. The token it contains is 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

​Generate administrator access

​Sample request

​Sample response

​Response elements

​Action on forms I-9

​Embedded administrator experience demo

Generate administrator access

Sample request

Sample response

Response elements

Action on forms I-9

Embedded administrator experience demo