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:

  1. Authenticate the administrator using the authenticateUri
  2. 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

ElementTypeDescription
employerIdstringThe unique identifier of the employer for whom E-Verify is being configured.
adminIdstringThe 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:

  1. Authenticate the administrator using the authenticateUri: this one-time-use token link signs the user in securely
  2. 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 the eVerifySettingsUri, or the page will not load properly.

Response Elements

ElementTypeDescription
authenticateUristringA secure, one-time-use link that signs the administrator in directly using a token
eVerifySettingsUristringA 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.

Jump to top