{"title":"employees resource type (v1.0)","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_employee/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_employee","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"(v1.0) An employee object in Dynamics 365 Business Central.","date":"2024-05-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"employees resource type (v1.0)","slug":"employees-resource-type-v10","at":0,"chars":3343},{"level":2,"title":"Methods","slug":"methods","at":360,"chars":340},{"level":2,"title":"Subpages","slug":"subpages","at":700,"chars":556},{"level":2,"title":"Properties","slug":"properties","at":1256,"chars":1278},{"level":2,"title":"Relationships","slug":"relationships","at":2534,"chars":22},{"level":2,"title":"JSON representation","slug":"json-representation","at":2556,"chars":585},{"level":2,"title":"Related information","slug":"related-information","at":3141,"chars":202}],"text":"# employees resource type (v1.0)\n> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.\nRepresents an employee in Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_employee_get|employees|Get an employee object.\nPOST employees<../api/dynamics_create_employee>|employees|Create an employee object.\nPATCH employees<../api/dynamics_employee_update>|employees|Update an employee object.\n../api/dynamics_employee_delete|none|Delete an employee object.\n## Subpages\nMethod|Return Type|Description\n../api/dynamics_employee_get_defaultdimensions|default dimensions|Gets the default dimensions of employee.\nPOST employee defaultDimensions<../api/dynamics_employee_create_defaultdimensions>|default dimensions|Creates the default dimensions of employee.\nPATCH employee defaultDimensions<../api/dynamics_employee_update_defaultdimensions>|default dimensions|Updates the default dimensions of employee.\n../api/dynamics_employee_delete_defaultdimensions|default dimensions|Deletes the default dimensions of employee.\n## Properties\nProperty|Type|Description\nid|GUID|The employee ID. Non-editable.\nnumber|string|The employee number. Read-Only.\ndisplayName|string|The employee givenName + surname. Read-Only.\ngivenName|string|The given name of the employee.\nmiddleName|string|The middle name of the employee.\nsurname|string|The surname of the employee\njobTitle|string|The full name of the employee\naddress|NAV.PostalAddress<dynamics_complextypes>|Specifies the employee's address. This address will appear on all resource documents for the employee.\nphoneNumber|string|Specifies the employee's telephone number.\nmobilePhone|string|Specifies the employee's mobile telephone number.\nemail|string|Specifies the employee's email address.\npersonalEmail|string|Specifies the employee's personal email address.\nemploymentDate|date|Specifies the date when the employee began to work for the company.\nterminationDate|date|Specifies the date when the employee was terminated, due to retirement or dismissal, for example.\nstatus|string|Specifies the employee's status. Possible values are Active, Inactive or Terminated\nbirthDate|date|Specifies the employee's date of birth.\npicture|stream|The employee picture. Read-Only.\nlastModifiedDateTime|datetime|The last datetime the employee was modified. Read-Only.\n## Relationships\nNone\n## JSON representation\nHere is a JSON representation of the resource.\n```json\n{\n    \"id\": \"GUID\",\n    \"number\": \"string\",\n    \"displayName\": \"string\",\n    \"givenName\": \"string\",\n    \"middleName\": \"string\",\n    \"surname\": \"string\",\n    \"jobTitle\": \"string\",\n    \"address\": \"NAV.PostalAddress\",\n    \"phoneNumber\": \"string\",\n    \"mobilePhone\": \"string\",\n    \"email\": \"string\",\n    \"personalEmail\": \"string\",\n    \"employmentDate\": \"date\",\n    \"terminationDate\": \"date\",\n    \"status\": \"string\",\n    \"birthDate\": \"date\",\n    \"picture\": \"stream\",\n    \"lastModifiedDateTime\": \"datetime\"\n}\n```\n## Related information\n../dynamics_error_codes\n../api/dynamics_employee_get\nPost Employee<../api/dynamics_create_employee>\nPatch Employee<../api/dynamics_employee_update>\n../api/dynamics_employee_delete"}