# userGroup resource type
Represents an user group 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>.
> NOTE
> User groups are replaced with security groups<../../upgrade/deprecated-features-user-groups> and will be deprecated in version 25. See security group APIs<dynamics_securitygroup> and Control Access to Business Central Using Security Groups</ui-security-groups>.
## Methods
Method|Return Type|Description
../api/dynamics_usergroup_get|userGroup|Gets a user group object.
../api/dynamics_usergroup_delete|none|Deletes a user group object.
POST userGroup<../api/dynamics_usergroup_create>|userGroup|Creates a user group object.
PATCH userGroup<../api/dynamics_usergroup_update>|userGroup|Updates a user group object.
## Navigation
Navigation|Return Type|Description
dynamics_usergrouppermission|userGroupPermissions|Gets the permissions of the userGroup.
dynamics_profile|profile|Gets the profile of the userGroup.
## Properties
Property|Type|Description
id|GUID|The unique ID of the user group. Non-editable.
code|string|The code of the user group.
displayName|string|Specifies the user group's name. This name will appear on all sales documents for the user group.
defaultProfileID|string|The ID of the defaultProfile.
assignToAllNewUsers|boolean|If true, all new users are assigned to user group.
## JSON representation
Here is a JSON representation of the userGroup resource.
```json
{
    "id": "GUID",
    "code": "string",
    "displayName": "string",
    "defaultProfileID": "string",
    "assignToAllNewUsers": "boolean"
}
```
## Related information
../api/dynamics_usergroup_get
../api/dynamics_usergroup_delete
POST userGroup<../api/dynamics_usergroup_create>
PATCH userGroup<../api/dynamics_usergroup_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_usergroup, 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_usergroup/
