Update an existing employee with an employer

curl --request PATCH \ --url https://api.symmetry.com/i9/v1/employers/{employerId}/employees/{employeeId} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "employment": { "employeeDocumentOptions": { "i9RemoteCounterSignAuthorized": true, "i9RemoteReverificationAuthorized": false }, "hireDate": "2025-05-19", "startDate": "2025-06-02", "status": "inactive" } } '

{ "employee": { "address": { "city": "some-city", "country": "US", "state": "AZ", "streetAddress1": "123 Somewhere ST", "streetAddress2": "", "zipCode": "12345" }, "appliedForSsn": false, "dateOfBirth": "1987-06-23", "emailAddress": "john.public@example.com", "employment": { "employeeDocumentOptions": { "i9RemoteCounterSignAuthorized": true, "i9RemoteReverificationAuthorized": false }, "hireDate": "2025-05-19", "startDate": "2025-06-02", "status": "active", "statusChangedAt": "2025-05-21T18:10:00.276Z", "statusChangedBy": "0" }, "firstName": "John", "id": "019615cf-5def-71a4-a27a-9ecc22018ace", "lastName": "Publicton", "socialSecurityNumber": "564-74-3215", "telephoneNumber": "480-596-1500" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

employerId

string

required

employeeId

string

required

Body

application/json

Employee information

dateOfBirth

string<date>

required

Date of birth associated with a Employee.

emailAddress

string

required

Email address associated with a Employee.

employment

object

required

Current employment record

Show child attributes

firstName

string

required

Employee's first name.

lastName

string

required

Employee's last name.

address

object

The address sub-element of the Employee element contains all data pertaining to Employee's physical address.

Show child attributes

appliedForSsn

boolean

Indicates whether the employee has applied for an SSN. If true, socialSecurityNumber cannot be provided. If false, socialSecurityNumber is required. For updates, this field is optional.

gender

enum<string>

Available options:

f,

m,

x

string<uuid>

middleName

string

Employee's middle name.

nickname

string

skipEverify

boolean

Allows employer to manage E-Verify cases manually via the E-Verify website directly. When true, employee will not be automatically sent to E-Verify when Form I-9 is completed.

Employee's Social Security Number. Must be exactly 9 digits. All non-numeric characters will be automatically removed before validation (for example, 123-45-6789 will be validated as 123456789). Required when appliedForSsn is false. Cannot be provided when appliedForSsn is true.

telephoneNumber

string

The phone number associated with a Employee. Required if remote verification (i9RemoteCounterSignAuthorized or i9RemoteReverificationAuthorized) is enabled.

Response

Employee response

employee

object

Employee information

Show child attributes