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.
Element | Type | Description |
---|---|---|
embeddedUri | A 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. | |
token | Token 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
Updated 4 days ago