Access: System, Admin, and ClientAdmin users with AdvanceAccess.ChangeW2Address.

This updates tax-form delivery data used for W-2 generation. It does not accept or change the W-2 electronic-delivery consent flag.

The W-2 mailing address is saved without payroll/STE validation, normalization, or an AddressFix_v10 correction round-trip; only structural model validation is applied.

Required address fields: addressLine1, addressCity, addressZIP and addressCountry are always required; addressState is required only when addressCountry is one of US, CA, MX (the countries-with-states list). middleName, suffix and addressLine2 are optional.

Request example:

{
  "firstName": "Jane",
  "middleName": "A",
  "lastName": "Employee",
  "suffix": "Jr",
  "address": {
    "addressLine1": "123 Main St",
    "addressLine2": "Suite 100",
    "addressCity": "Denver",
    "addressState": "CO",
    "addressZIP": "80202",
    "addressCountry": "US"
  }
}
            

Successful response example:

{
  "electronicOnly": false,
  "firstName": "Jane",
  "middleName": "A",
  "lastName": "Employee",
  "suffix": "Jr",
  "address": {
    "id": 12345,
    "addressLine1": "123 Main St",
    "addressLine2": "Suite 100",
    "addressCity": "Denver",
    "addressState": "CO",
    "addressZIP": "80202",
    "addressCountry": "US"
  },
  "addressId": 12345
}