{"title":"userPermission resource type","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/resources/dynamics_userpermission/","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_userpermission, 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_userpermission","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":"An user permission object in Dynamics 365 Business Central.","date":"2024-05-31","meta":{"topic":"reference"},"outline":[{"level":1,"title":"userPermission resource type","slug":"userpermission-resource-type","at":0,"chars":1981},{"level":2,"title":"Methods","slug":"methods","at":275,"chars":417},{"level":2,"title":"Navigation","slug":"navigation","at":692,"chars":283},{"level":2,"title":"Properties","slug":"properties","at":975,"chars":491},{"level":2,"title":"JSON representation","slug":"json-representation","at":1466,"chars":301},{"level":2,"title":"Related information","slug":"related-information","at":1767,"chars":214}],"text":"# userPermission resource type\nRepresents an user permission 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_userpermission_get|userPermission|Gets a user permission object.\n../api/dynamics_userpermission_delete|none|Deletes a user permission object.\nPOST userPermission<../api/dynamics_userpermission_create>|userPermission|Creates a user permission object.\nPATCH userPermission<../api/dynamics_userpermission_update>|userPermission|Updates a user permission object.\n## Navigation\nNavigation|Return Type|Description\ndynamics_user|user|Gets the user of the userPermission.\ndynamics_permissionset|permissionSet|Gets the permissionset of the userPermission.\ndynamics_automationcompany|automationCompany|Gets the automationcompany of the userPermission.\n## Properties\nProperty|Type|Description\nid|GUID|The unique ID of the user permission. Read-Only.\nuserSecurityId|GUID|The unique ID of the user security.\nroleId|string|The unique ID of the user permission role.\ndisplayName|string|Specifies the user permission's name. This name will appear on all sales documents for the user permission.\ncompany|string|The company name.\nappId|GUID|The ID of the App.\nextensionName|string|The name of the extension.\nscope|string|Scope of the user permission.\n## JSON representation\nHere is a JSON representation of the userPermission resource.\n```json\n{\n    \"id\": \"GUID\",\n    \"userSecurityId\": \"GUID\",\n    \"roleId\": \"string\",\n    \"displayName\": \"string\",\n    \"company\": \"string\",\n    \"appId\": \"GUID\",\n    \"extensionName\": \"string\",\n    \"scope\": \"string\"\n}\n```\n## Related information\n../api/dynamics_userpermission_get\n../api/dynamics_userpermission_delete\nPOST userPermission<../api/dynamics_userpermission_create>\nPATCH userPermission<../api/dynamics_userpermission_update>"}