employees resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents an employee in Dynamics 365 Business Central.

Methods

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.

Properties

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 job title 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.

Relationships

None

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"
}