PersonCreate

  • forename1
    Type: string
    min length:  
    1
    max length:  
    100
    required

    Person's first forename, used for payroll and HMRC reporting.

  • surname
    Type: string
    min length:  
    1
    max length:  
    100
    required

    Person's surname, used for payroll and HMRC reporting.

  • dateOfBirth
    Type: stringFormat: date

    Employee's date of birth. Required before their first HMRC filing.

  • email
    Type: stringFormat: email

    Employer-confirmed email address used for PayrollKit-managed Payslip delivery.

  • forename2
    Type: string
    min length:  
    1
    max length:  
    100

    Person's second forename, when they have one. Omit it when they do not.

  • gender
    Type: "female" or "male"enum

    Employee's current gender as required for HMRC reporting. Required before their first HMRC filing.

  • homeAddress
    Type: object
    Properties: 6
  • nationalInsuranceNumber
    Type: string

    Employee's National Insurance number without spaces. Omit it when it is not known; never send an invented or temporary number.

  • title
    Type: stringenum

    Person's title, when given. Omit it when the employee has not supplied one.

    values
    mrmrsmsmissdrlordladysirprofrevcaptainbursar