{"title":"user resource type","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/resources/dynamics_user/","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/administration/resources/dynamics_user, 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/administration/resources/dynamics_user","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":"A user object in Dynamics 365 Business Central.","date":"2024-09-02","meta":{"topic":"reference"},"outline":[{"level":1,"title":"user resource type","slug":"user-resource-type","at":0,"chars":2247},{"level":2,"title":"Methods","slug":"methods","at":254,"chars":160},{"level":2,"title":"Bound Actions","slug":"bound-actions","at":414,"chars":821},{"level":2,"title":"Navigation","slug":"navigation","at":1235,"chars":292},{"level":2,"title":"Properties","slug":"properties","at":1527,"chars":375},{"level":2,"title":"JSON representation","slug":"json-representation","at":1902,"chars":258},{"level":2,"title":"Related information","slug":"related-information","at":2160,"chars":87}],"text":"# user resource type\nRepresents an user in Dynamics 365 Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../../api-reference/v2.0/enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_user_get|user|Gets a user object.\nPATCH user<../api/dynamics_user_update>|user|Updates a user object.\n## Bound Actions\nThe user resource type offers a bound action called getNewUsersFromOffice365Async which get new users from office 365 asyncs the corresponding user batch.\nThis is illustrated in the following example:\n`POST https://<server address>:<server API port>/<server instance name>/api/v2.0/companies({id})/users({id})/Microsoft.NAV.getNewUsersFromOffice365Async`\nThe response has no content; the response code is 204.\nThe user resource type offers a bound action called getNewUsersFromOffice365 which get new users from office 365s the corresponding user batch.\nThis is illustrated in the following example:\n`POST https://<server address>:<server API port>/<server instance name>/api/v2.0/companies({id})/users({id})/Microsoft.NAV.getNewUsersFromOffice365`\nThe response has no content; the response code is 204.\n## Navigation\nNavigation|Return Type|Description\ndynamics_securitygroupmember|securityGroupMembers|Gets the securitygroupmembers of the user.\ndynamics_userpermission|userPermissions|Gets the userpermissions of the user.\ndynamics_scheduledjob|scheduledJobs|Gets the scheduledjobs of the user.\n## Properties\nProperty|Type|Description\nuserSecurityId|GUID|The unique ID of the user security.\nuserName|string|Specifies the user name.\ndisplayName|string|Specifies the user's name. This name will appear on all sales documents for the user.\nstate|string|Specifies the user's state.\nexpiryDate|datetime|The date of expiration.\ncontactEmail|string|Specifies the user's email.\n## JSON representation\nHere is a JSON representation of the user resource.\n```json\n{\n    \"userSecurityId\": \"GUID\",\n    \"userName\": \"string\",\n    \"displayName\": \"string\",\n    \"state\": \"string\",\n    \"expiryDate\": \"datetime\",\n    \"contactEmail\": \"string\"\n}\n```\n## Related information\n../api/dynamics_user_get\nPATCH user<../api/dynamics_user_update>"}