# Visma Nmbrs — HRIS API: gotchas

> Canonical URL: https://developers.apideck.com/apis/hris/nmbrs/gotchas

## GET /hris/employees

We keep track of the "List Employees" response for NMBRS virtual webhooks events, which contains fewer fields compared to the "Get Employee" response.
## POST /hris/employees

When creating an employee, the `employment_role.type` values accepted for NMbrs are `employee`, `contractor` and `freelance`.

**Important**: Nmbrs requires nationality data (`nationalities` field) for employees with type "payroll". When nationality is not provided:
- Employees with `employment_role.type: "employee"` are automatically created as "external" type instead of "payroll" to avoid validation errors
- This may affect payroll processing, benefits eligibility, and reporting in Nmbrs
- To create employees as "payroll" type, ensure the `nationalities` field contains at least one ISO country code
- Contractors and freelancers are always created as "external" type regardless of nationality


[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)