# userPermission resource type
Represents an user permission in Dynamics 365 Business Central.
> NOTE
> 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>.
## Methods
Method|Return Type|Description
../api/dynamics_userpermission_get|userPermission|Gets a user permission object.
../api/dynamics_userpermission_delete|none|Deletes a user permission object.
POST userPermission<../api/dynamics_userpermission_create>|userPermission|Creates a user permission object.
PATCH userPermission<../api/dynamics_userpermission_update>|userPermission|Updates a user permission object.
## Navigation
Navigation|Return Type|Description
dynamics_user|user|Gets the user of the userPermission.
dynamics_permissionset|permissionSet|Gets the permissionset of the userPermission.
dynamics_automationcompany|automationCompany|Gets the automationcompany of the userPermission.
## Properties
Property|Type|Description
id|GUID|The unique ID of the user permission. Read-Only.
userSecurityId|GUID|The unique ID of the user security.
roleId|string|The unique ID of the user permission role.
displayName|string|Specifies the user permission's name. This name will appear on all sales documents for the user permission.
company|string|The company name.
appId|GUID|The ID of the App.
extensionName|string|The name of the extension.
scope|string|Scope of the user permission.
## JSON representation
Here is a JSON representation of the userPermission resource.
```json
{
    "id": "GUID",
    "userSecurityId": "GUID",
    "roleId": "string",
    "displayName": "string",
    "company": "string",
    "appId": "GUID",
    "extensionName": "string",
    "scope": "string"
}
```
## Related information
../api/dynamics_userpermission_get
../api/dynamics_userpermission_delete
POST userPermission<../api/dynamics_userpermission_create>
PATCH userPermission<../api/dynamics_userpermission_update>

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. https://jonas-paprotka.de/docs/dev-itpro/administration/resources/dynamics_userpermission/
