3. Configure E-Verify
Once you've registered your employer and administrator, the next step is to configure E-Verify for any employer that will be using the E-Verify program as part of the I-9 process.
Implementing E-Verify configuration in your platform is a two-step process:
- Authenticate the administrator using the
authenticateUri
- Navigate to the
eVerifySettingsUri
to complete the configuration
The administrator must be authenticated before accessing the E-Verify settings page. Both links are returned by the API and must be used in sequence to ensure a successful configuration.
Generate E-Verify Configuration Page
The /employers/{employerId}/admins/{adminId}/everifySettings/generateToken
GET endpoint generates a secure, embeddable link to the E-Verify configuration for a valid administrator. Once embedded in your platform, the administrator can complete the form to enable automatic E-Verify case creation for all completed Forms I-9 under the employer.
Sample Request
curl --location 'https://api.symmetry.com/i9/v1/employers/01971d41-b29d-75cf-a308-12345678/admins/01972152-29ab-78f4-93ce-12345678/everifySettings/generateToken' \
--header 'Authorization: Bearer ••••••'
Path Parameters
Element | Type | Description |
---|---|---|
employerId | string | The unique identifier of the employer for whom E-Verify is being configured. |
adminId | string | The ID of the administrator completing the E-Verify configuration. |
Response
A successful response returns a JSON object with two URLs: one for authentication and one for accessing the configuration page.
{
"authenticateUri": "https://symmetry.workbright.com/sign_in_with_token?token=12345670a239f8b5809c",
"eVerifySettingsUri": "https://symmetry.workbright.com/admin/everify/accounts"
}
Two-Step Implementation Process
To integrate the E-Verify settings page into your platform:
- Authenticate the administrator using the
authenticateUri
: this one-time-use token link signs the user in securely - Embed or redirect to the
eVerifySettingsUri
: this opens the E-Verify settings form for configuration- The administrator must be signed in using the
authenticateUri
before accessing theeVerifySettingsUri
, or the page will not load properly.
- The administrator must be signed in using the
Response Elements
Element | Type | Description |
---|---|---|
authenticateUri | string | A secure, one-time-use link that signs the administrator in directly using a token |
eVerifySettingsUri | string | A direct link to the E-Verify configuration page where the authenticated administrator can complete or manage E-Verify setup for the employer. The administrator must be authenticated using the authenticateUri prior to accessing the eVerifySettingsUri . |
Updated 4 days ago