Skip to main content

Why Employment Fields Are Automatically Populated When Creating Employees via API

  • Nov 19, 2026 9:43 AM UTC
  • 0 replies
  • 1 view
  • Translate All

When you create an employee through the API, Bob may automatically populate Employment fields that weren’t included in your request.

The Create company employee endpoint requires the following minimum fields:

  • Email
  • First name
  • Surname
  • Site
  • Start date

Because site is required, the employee is assigned to a site as part of the creation request.

For example, an employee created with the London site can be sent using only the required details:

{

  "firstName": "James",

  "surname": "Bond",

  "email": "james.bond@hibob.io",

  "work": {

    "site": "London",

    "startDate": "2026-11-20"

  }

}

Even though the request doesn't include Employment fields, Bob creates the employee's initial Employment record and automatically populates values such as:

  • Weekly hours: 40
  • FTE %: 100
  • Vacation calendar: Site default
  • Employment contract: Full time

This means seeing these values in the audit trail doesn't necessarily mean they were explicitly included in the API payload.

For example, the London site in this test has a Monday–Friday working pattern of eight hours per day, for a total of 40 weekly hours, and has a calendar configured for the site.

If your integration needs to populate additional employee data during creation, you can use supported fields from the Fields Metadata API in the request.

For more information, see: