Group

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.

type Group {
  id: ID!
  name: String!
  description: String
  role: GroupRole!
  createdAt: DateTime!
  updatedAt: DateTime!
}

Fields

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

Unique identifier for this group.

Group.name ● String! non-null scalar {#name}

Human-readable name displayed in the UI and API responses.

Group.description ● String scalar {#description}

Optional text explaining the purpose of this group.

Group.role ● GroupRole! non-null enum {#role}

The access level this group grants to its members.

Group.createdAt ● DateTime! non-null scalar {#created-at}

When this group was created (UTC).

Group.updatedAt ● DateTime! non-null scalar {#updated-at}

When this group was last modified (UTC).

Returned By

group query

Member Of

GroupPayload object ● GroupsPage object