---
title: "Changes to Invite a worker to join Maqqie"
method: POST
path: "/public/onboarding/v1/invite-worker"
---

# Changes to Invite a worker to join Maqqie

`POST /public/onboarding/v1/invite-worker`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 14 revisions.

- **2026-09-29** `f9510f3f4b22`: 7 breaking, 19 info
- **2026-09-29** `3352b56bb8fe`: 5 breaking, 21 warning, 14 info
- **2026-09-16** `ccf9834e5006`: 7 breaking, 19 info
- **2026-09-15** `8085d4c1ab80`: 5 breaking, 21 warning, 14 info
- **2026-09-10** `d26fed912541`: 7 breaking, 19 info
- **2026-09-08** `34a5be0cd6a2`: 5 breaking, 21 warning, 14 info
- **2026-08-21** `41e5cd97d4d7`: 7 breaking, 19 info
- **2026-08-21** `4c08f91a54b5`: 5 breaking, 21 warning, 14 info

## Changes

- **2026-09-29** `f9510f3f4b22`: 7 breaking, 19 info
  - added the new required request property `emailAddress`
  - added the new required request property `firstName`
  - added the new required request property `mobileNumber`
  - added the new required request property `zip`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `city`
  - added the new optional request property `dateOfBirth`
  - added the new optional request property `freelanceChamberOfCommerceNumber`
  - added the new optional request property `freelanceVatNumber`
  - added the new optional request property `freelanceVatType`
  - added the new optional request property `gender`
  - added the new optional request property `houseNumber`
  - added the new optional request property `houseNumberAddition`
  - added the new optional request property `iban`
  - added the new optional request property `initials`
  - added the new optional request property `lastName`
  - added the new optional request property `middleName`
  - added the new optional request property `nationality`
  - added the new optional request property `paymentPeriod`
  - added the new optional request property `shouldNotifyWorkerOfAccountCreation`
  - added the new optional request property `street`
  - added the new optional request property `wageTaxRebate`
  - added the required property `message` to the response with the `200` status
  - added the required property `workerId` to the response with the `200` status
- **2026-09-29** `3352b56bb8fe`: 5 breaking, 21 warning, 14 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the required property `message` from the response with the `200` status
  - removed the required property `workerId` from the response with the `200` status
  - removed the request property `city`
  - removed the request property `dateOfBirth`
  - removed the request property `emailAddress`
  - removed the request property `firstName`
  - removed the request property `freelanceChamberOfCommerceNumber`
  - removed the request property `freelanceVatNumber`
  - removed the request property `freelanceVatType`
  - removed the request property `gender`
  - removed the request property `houseNumber`
  - removed the request property `houseNumberAddition`
  - removed the request property `iban`
  - removed the request property `initials`
  - removed the request property `lastName`
  - removed the request property `middleName`
  - removed the request property `mobileNumber`
  - removed the request property `nationality`
  - removed the request property `paymentPeriod`
  - removed the request property `shouldNotifyWorkerOfAccountCreation`
  - removed the request property `street`
  - removed the request property `wageTaxRebate`
  - removed the request property `zip`
  - response schema `application/json` enum value removed `COUNTRY_ADDRESS_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `EMAIL_ADDRESS_IN_USE`
  - response schema `application/json` enum value removed `INVALID_BSN`
  - response schema `application/json` enum value removed `INVALID_COUNTRY`
  - response schema `application/json` enum value removed `INVALID_DOCUMENT`
  - response schema `application/json` enum value removed `INVALID_EMAIL`
  - response schema `application/json` enum value removed `INVALID_HOUSE_NUMBER_ADDITION`
  - response schema `application/json` enum value removed `INVALID_IBAN`
  - response schema `application/json` enum value removed `INVALID_NATIONALITY`
  - response schema `application/json` enum value removed `INVALID_NON_EER_WORKER_AND_NATIONALITY_COMBINATION`
  - response schema `application/json` enum value removed `INVALID_PHONE_NUMBER`
  - response schema `application/json` enum value removed `INVALID_ZIP_CODE`
  - response schema `application/json` enum value removed `LEGAL_WORK_CATEGORY_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `WORKER_ALREADY_HAS_AN_ACCOUNT`
- **2026-09-16** `ccf9834e5006`: 7 breaking, 19 info
  - added the new required request property `emailAddress`
  - added the new required request property `firstName`
  - added the new required request property `mobileNumber`
  - added the new required request property `zip`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `city`
  - added the new optional request property `dateOfBirth`
  - added the new optional request property `freelanceChamberOfCommerceNumber`
  - added the new optional request property `freelanceVatNumber`
  - added the new optional request property `freelanceVatType`
  - added the new optional request property `gender`
  - added the new optional request property `houseNumber`
  - added the new optional request property `houseNumberAddition`
  - added the new optional request property `iban`
  - added the new optional request property `initials`
  - added the new optional request property `lastName`
  - added the new optional request property `middleName`
  - added the new optional request property `nationality`
  - added the new optional request property `paymentPeriod`
  - added the new optional request property `shouldNotifyWorkerOfAccountCreation`
  - added the new optional request property `street`
  - added the new optional request property `wageTaxRebate`
  - added the required property `message` to the response with the `200` status
  - added the required property `workerId` to the response with the `200` status
- **2026-09-15** `8085d4c1ab80`: 5 breaking, 21 warning, 14 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the required property `message` from the response with the `200` status
  - removed the required property `workerId` from the response with the `200` status
  - removed the request property `city`
  - removed the request property `dateOfBirth`
  - removed the request property `emailAddress`
  - removed the request property `firstName`
  - removed the request property `freelanceChamberOfCommerceNumber`
  - removed the request property `freelanceVatNumber`
  - removed the request property `freelanceVatType`
  - removed the request property `gender`
  - removed the request property `houseNumber`
  - removed the request property `houseNumberAddition`
  - removed the request property `iban`
  - removed the request property `initials`
  - removed the request property `lastName`
  - removed the request property `middleName`
  - removed the request property `mobileNumber`
  - removed the request property `nationality`
  - removed the request property `paymentPeriod`
  - removed the request property `shouldNotifyWorkerOfAccountCreation`
  - removed the request property `street`
  - removed the request property `wageTaxRebate`
  - removed the request property `zip`
  - response schema `application/json` enum value removed `COUNTRY_ADDRESS_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `EMAIL_ADDRESS_IN_USE`
  - response schema `application/json` enum value removed `INVALID_BSN`
  - response schema `application/json` enum value removed `INVALID_COUNTRY`
  - response schema `application/json` enum value removed `INVALID_DOCUMENT`
  - response schema `application/json` enum value removed `INVALID_EMAIL`
  - response schema `application/json` enum value removed `INVALID_HOUSE_NUMBER_ADDITION`
  - response schema `application/json` enum value removed `INVALID_IBAN`
  - response schema `application/json` enum value removed `INVALID_NATIONALITY`
  - response schema `application/json` enum value removed `INVALID_NON_EER_WORKER_AND_NATIONALITY_COMBINATION`
  - response schema `application/json` enum value removed `INVALID_PHONE_NUMBER`
  - response schema `application/json` enum value removed `INVALID_ZIP_CODE`
  - response schema `application/json` enum value removed `LEGAL_WORK_CATEGORY_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `WORKER_ALREADY_HAS_AN_ACCOUNT`
- **2026-09-10** `d26fed912541`: 7 breaking, 19 info
  - added the new required request property `emailAddress`
  - added the new required request property `firstName`
  - added the new required request property `mobileNumber`
  - added the new required request property `zip`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `city`
  - added the new optional request property `dateOfBirth`
  - added the new optional request property `freelanceChamberOfCommerceNumber`
  - added the new optional request property `freelanceVatNumber`
  - added the new optional request property `freelanceVatType`
  - added the new optional request property `gender`
  - added the new optional request property `houseNumber`
  - added the new optional request property `houseNumberAddition`
  - added the new optional request property `iban`
  - added the new optional request property `initials`
  - added the new optional request property `lastName`
  - added the new optional request property `middleName`
  - added the new optional request property `nationality`
  - added the new optional request property `paymentPeriod`
  - added the new optional request property `shouldNotifyWorkerOfAccountCreation`
  - added the new optional request property `street`
  - added the new optional request property `wageTaxRebate`
  - added the required property `message` to the response with the `200` status
  - added the required property `workerId` to the response with the `200` status
- **2026-09-08** `34a5be0cd6a2`: 5 breaking, 21 warning, 14 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the required property `message` from the response with the `200` status
  - removed the required property `workerId` from the response with the `200` status
  - removed the request property `city`
  - removed the request property `dateOfBirth`
  - removed the request property `emailAddress`
  - removed the request property `firstName`
  - removed the request property `freelanceChamberOfCommerceNumber`
  - removed the request property `freelanceVatNumber`
  - removed the request property `freelanceVatType`
  - removed the request property `gender`
  - removed the request property `houseNumber`
  - removed the request property `houseNumberAddition`
  - removed the request property `iban`
  - removed the request property `initials`
  - removed the request property `lastName`
  - removed the request property `middleName`
  - removed the request property `mobileNumber`
  - removed the request property `nationality`
  - removed the request property `paymentPeriod`
  - removed the request property `shouldNotifyWorkerOfAccountCreation`
  - removed the request property `street`
  - removed the request property `wageTaxRebate`
  - removed the request property `zip`
  - response schema `application/json` enum value removed `COUNTRY_ADDRESS_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `EMAIL_ADDRESS_IN_USE`
  - response schema `application/json` enum value removed `INVALID_BSN`
  - response schema `application/json` enum value removed `INVALID_COUNTRY`
  - response schema `application/json` enum value removed `INVALID_DOCUMENT`
  - response schema `application/json` enum value removed `INVALID_EMAIL`
  - response schema `application/json` enum value removed `INVALID_HOUSE_NUMBER_ADDITION`
  - response schema `application/json` enum value removed `INVALID_IBAN`
  - response schema `application/json` enum value removed `INVALID_NATIONALITY`
  - response schema `application/json` enum value removed `INVALID_NON_EER_WORKER_AND_NATIONALITY_COMBINATION`
  - response schema `application/json` enum value removed `INVALID_PHONE_NUMBER`
  - response schema `application/json` enum value removed `INVALID_ZIP_CODE`
  - response schema `application/json` enum value removed `LEGAL_WORK_CATEGORY_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `WORKER_ALREADY_HAS_AN_ACCOUNT`
- **2026-08-21** `41e5cd97d4d7`: 7 breaking, 19 info
  - added the new required request property `emailAddress`
  - added the new required request property `firstName`
  - added the new required request property `mobileNumber`
  - added the new required request property `zip`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `string` for status `400`
  - added the new optional request property `city`
  - added the new optional request property `dateOfBirth`
  - added the new optional request property `freelanceChamberOfCommerceNumber`
  - added the new optional request property `freelanceVatNumber`
  - added the new optional request property `freelanceVatType`
  - added the new optional request property `gender`
  - added the new optional request property `houseNumber`
  - added the new optional request property `houseNumberAddition`
  - added the new optional request property `iban`
  - added the new optional request property `initials`
  - added the new optional request property `lastName`
  - added the new optional request property `middleName`
  - added the new optional request property `nationality`
  - added the new optional request property `paymentPeriod`
  - added the new optional request property `shouldNotifyWorkerOfAccountCreation`
  - added the new optional request property `street`
  - added the new optional request property `wageTaxRebate`
  - added the required property `message` to the response with the `200` status
  - added the required property `workerId` to the response with the `200` status
- **2026-08-21** `4c08f91a54b5`: 5 breaking, 21 warning, 14 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `string` to no type for status `400`
  - removed the required property `message` from the response with the `200` status
  - removed the required property `workerId` from the response with the `200` status
  - removed the request property `city`
  - removed the request property `dateOfBirth`
  - removed the request property `emailAddress`
  - removed the request property `firstName`
  - removed the request property `freelanceChamberOfCommerceNumber`
  - removed the request property `freelanceVatNumber`
  - removed the request property `freelanceVatType`
  - removed the request property `gender`
  - removed the request property `houseNumber`
  - removed the request property `houseNumberAddition`
  - removed the request property `iban`
  - removed the request property `initials`
  - removed the request property `lastName`
  - removed the request property `middleName`
  - removed the request property `mobileNumber`
  - removed the request property `nationality`
  - removed the request property `paymentPeriod`
  - removed the request property `shouldNotifyWorkerOfAccountCreation`
  - removed the request property `street`
  - removed the request property `wageTaxRebate`
  - removed the request property `zip`
  - response schema `application/json` enum value removed `COUNTRY_ADDRESS_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `EMAIL_ADDRESS_IN_USE`
  - response schema `application/json` enum value removed `INVALID_BSN`
  - response schema `application/json` enum value removed `INVALID_COUNTRY`
  - response schema `application/json` enum value removed `INVALID_DOCUMENT`
  - response schema `application/json` enum value removed `INVALID_EMAIL`
  - response schema `application/json` enum value removed `INVALID_HOUSE_NUMBER_ADDITION`
  - response schema `application/json` enum value removed `INVALID_IBAN`
  - response schema `application/json` enum value removed `INVALID_NATIONALITY`
  - response schema `application/json` enum value removed `INVALID_NON_EER_WORKER_AND_NATIONALITY_COMBINATION`
  - response schema `application/json` enum value removed `INVALID_PHONE_NUMBER`
  - response schema `application/json` enum value removed `INVALID_ZIP_CODE`
  - response schema `application/json` enum value removed `LEGAL_WORK_CATEGORY_NOT_SUPPORTED`
  - response schema `application/json` enum value removed `WORKER_ALREADY_HAS_AN_ACCOUNT`

---

[Operation](https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/onboarding/v1/invite-worker/post.md) - [API](https://skmtc.dev/maqqie/apis/maqqie-public-api.md) - [Page](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/onboarding/v1/invite-worker/post)
