Sign in

v1

latestOpenAPI 3.0.12026-07-245752052.0 MB
eins

Update one or multiple existing Employer Identification Numbers (EINs) metadata

patch/api/serviceorganizations/processes/mcp/eins

Request body

OR

Example request

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "label": "Warehouse Managers EIN",
  "linkToWorkerProps": [
    {
      "workerPropKey": "hireDate",
      "workerPropValue": [
        "10/20/2025",
        "10/25/2025"
      ]
    }
  ],
  "registrationInfo": {
    "name": "Acme Corp",
    "address": {
      "street": "123 Main St",
      "city": "San Francisco",
      "country": "US",
      "zip": "94105"
    },
    "settings_time_zone": "America/Los_Angeles"
  }
}

Response

Successfully updated EIN(s)

uuidstring uuid
createdAtstring date-time
createdBystring uuid
lastUpdatedAtstring date-time
lastUpdatedBystring uuid
lastUpdatedByAudiencestring
lastUpdatedByAudienceUuidstring uuid
lastUpdatedByImpersonatedBystring uuid
lastUpdatedByCompanyUuidstring uuid
lastUpdatedByEnterpriseUuidstring uuid
companyUuidstring uuid
labelstring
einstring required
hireBrandIdsstring[]
isDefaultboolean required

Example response

{
  "uuid": "f4428d27-c089-40c4-aa83-ce02e1ee1426",
  "createdAt": "2021-05-05T01:02:03.924Z",
  "createdBy": "1e4e9128-fbb2-4b0a-97fc-f65bb1efee55",
  "lastUpdatedAt": "2021-05-05T04:05:06.924Z",
  "lastUpdatedBy": "7097bb82-61bd-4724-82ac-eab598190e47",
  "lastUpdatedByAudience": "employer",
  "lastUpdatedByAudienceUuid": "68df4316-590a-4081-9f24-9d9311977c9d",
  "lastUpdatedByImpersonatedBy": "3462e1d4-0e27-4798-b4a2-76412ab21892",
  "lastUpdatedByCompanyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
  "lastUpdatedByEnterpriseUuid": "a6420cdc-285a-4f75-8ccc-8edff6d60c0a",
  "label": "Warehouse Managers EIN",
  "ein": "12-3456789",
  "linkToWorkerProps": [
    {
      "workerPropKey": "hireBrandId"
    }
  ],
  "registrationInfo": {
    "name": "Acme Corporation",
    "address": {
      "street": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "country": "US",
      "zip": "94105"
    },
    "settings_time_zone": "America/Los_Angeles"
  },
  "isDefault": true
}