Skip to main content
You can create an employee even if some details are not known yet, for example a new starter whose NI number hasn’t arrived.
  • Leave out a satellite you have no data for. Only core is required.
  • Send null for a field whose value is not known yet, where the field allows it.
  • Every field of a satellite you send must still be present, and every value you send must be valid.

Rejected and accepted

Invalid values are rejected when you send them (422), for example a tax code HMRC would not issue, or a gender other than M or F. Missing data is accepted: a satellite you leave out, or a field that takes null. Add it later with a PUT (see Changing data). Some of the missing data is needed before the employee can be paid or reported to HMRC: the job, tax and insurance satellites, and the NI number where the employee has one.

What payroll still needs

Get Employee Status will report what still stands between the employee’s data and a completed payroll. It comes in a future release; until then it returns no findings, so send all the details you hold.