Skip to main content

Usergroup

Organizational unit for hierarchical user and company management.

Usergroups provide a hierarchical structure for organizing users, companies, and customers. They enable inheritance of settings, permissions, and configurations throughout the organizational tree.

type Usergroup {
id: Int! @deprecated
usergroupId: Int!
name: String!
hidden: YesNo
inheritProductList: YesNo
path: String
slug: String
tag: String
createdAt: DateTime
lastModifiedAt: DateTime
parentUsergroupId: Int!
usergroup: Usergroup! @deprecated
usergroups: [Usergroup!]! @deprecated
companies(
input: CompanySearchArguments = [object Object]
): CompaniesResponse
customers: [Customer!]!
}

Fields

Usergroup.id ● Int! deprecated non-null scalar

DEPRECATED

This property is no longer relevant or necessary, use usergroupId instead.

Legacy unique identifier for the usergroup.

Deprecated identifier maintained for backward compatibility. Use usergroupId for new implementations.

Usergroup.usergroupId ● Int! non-null scalar

Unique identifier for the usergroup.

Primary key used to reference the usergroup throughout the system and establish hierarchical relationships.

Usergroup.name ● String! non-null scalar

Display name of the usergroup.

Human-readable name used for identification and display in user interfaces. Must be unique within the parent usergroup.

Usergroup.hidden ● YesNo enum

Visibility flag for administrative operations.

When set to 'Y', the usergroup is hidden from standard user interfaces and is only used for background operations or system processes.

Usergroup.inheritProductList ● YesNo enum

Product list inheritance configuration.

When set to 'Y', the usergroup inherits product lists from its parent usergroup. When set to 'N', it maintains its own product list configuration.

Usergroup.path ● String scalar

Hierarchical path to the organizational root.

Comma-separated list of IDs representing the path from this usergroup to the root of the organizational hierarchy. Used for inheritance calculations and permission resolution.

Usergroup.slug ● String scalar

URL-friendly identifier for the usergroup.

Unique slug used in URLs and API endpoints for human-readable usergroup identification. Must be URL-safe and unique within the parent usergroup.

Usergroup.tag ● String scalar

Classification tag for the usergroup.

Custom tag or category used for grouping, filtering, or classification purposes within the organizational structure.

Usergroup.createdAt ● DateTime scalar

Timestamp when the usergroup was created.

Automatically set when the usergroup is first created in the system. Used for auditing and tracking organizational changes.

Usergroup.lastModifiedAt ● DateTime scalar

Timestamp when the usergroup was last modified.

Automatically updated whenever any usergroup information is changed. Used for auditing and synchronization purposes.

Usergroup.parentUsergroupId ● Int! non-null scalar

Identifier of the parent usergroup.

References the parent usergroup in the organizational hierarchy. Used for inheritance and permission calculations. Null for root-level usergroups.

Usergroup.usergroup ● Usergroup! deprecated non-null object

DEPRECATED

This field is deprecated and will be removed in a future

Usergroup.usergroups ● [Usergroup!]! deprecated non-null object

DEPRECATED

This field is deprecated and will be removed in a future

Usergroup.companies ● CompaniesResponse object

Companies contained within this usergroup.

Paginated list of all companies that belong to this usergroup, including their relationships and organizational context.

Usergroup.companies.input ● CompanySearchArguments input

Usergroup.customers ● [Customer!]! non-null object

Returned By

usergroup query ● usergroupCreate mutation ● usergroupUpdate mutation

Member Of

Company object ● Customer object ● User object ● Usergroup object ● UsergroupsResponse object