employees resource type

Represents an employee in Dynamics 365 Business Central.


For information about enabling APIs for Dynamics NAV see Enabling the APIs for Microsoft Dynamics NAV.


Method Return Type Description
GET employees employees Get an employee object.
POST employees employees Create an employee object.
PATCH employees employees Update an employee object.
DELETE employees none Delete an employee object.


Property Type Description
id GUID The employee ID. Non-editable.
number string The employee number. Read-Only.
displayName string The employee givenName + surname. Read-Only.
givenName string The given name of the employee.
middleName string The middle name of the employee.
surname string The surname of the employee
jobTitle string The full name of the employee
address NAV.PostalAddress Specifies the employee's address. This address will appear on all resource documents for the employee.
phoneNumber string Specifies the employee's telephone number.
mobilePhone string Specifies the employee's mobile telephone number.
email string Specifies the employee's email address.
personalEmail string Specifies the employee's personal email address.
employmentDate date Specifies the date when the employee began to work for the company.
terminationDate date Specifies the date when the employee was terminated, due to retirement or dismissal, for example.
status string Specifies the employee's status. Possible values are Active, Inactive or Terminated
birthDate date Specifies the employee's date of birth.
picture stream The employee picture. Read-Only.
lastModifiedDateTime datetime The last datetime the employee was modified. Read-Only.



JSON representation

Here is a JSON representation of the resource.

    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "givenName": "string",
    "middleName": "string",
    "surname": "string",
    "jobTitle": "string",
    "address": "NAV.PostalAddress",
    "phoneNumber": "string",
    "mobilePhone": "string",
    "email": "string",
    "personalEmail": "string",
    "employmentDate": "date",
    "terminationDate": "date",
    "status": "string",
    "birthDate": "date",
    "picture": "stream",
    "lastModifiedDateTime": "datetime"

See also

Working with Dynamics 365 Business Central in Microsoft Graph
Enabling the APIs for Microsoft Dynamics NAV
Endpoints for the APIs
Error Codes
Get Employee
Post Employee
Patch Employee
Delete Employee