group

Retrieve a single group by its identifier.

Returns null with a NOT_FOUND error if the group does not exist or you do not have permission to view it.

group(
  organizationId: ID!
  id: ID!
): Group

Arguments

group.organizationId ● ID! non-null scalar {#organization-id}

Your organization's unique identifier.

group.id ● ID! non-null scalar {#id}

The group's unique identifier.

Type

Group object

A collection of users and service accounts that share the same access level within your organization.

Groups are the primary mechanism for managing access control in Massdriver. Rather than assigning permissions to individual users, you add them to groups that define what they can see and do.

Built-in groups — Every organization starts with an Admins group (organization_admin role) and a Viewers group (organization_viewer role). These cannot be deleted.

Custom groups — Create custom groups with the CUSTOM role to grant project-level access. Each custom group can be assigned project_admin or project_viewer on specific projects.

Members — Both human users and service accounts can be group members. Users are added via email invitation; service accounts are added directly.