group.* events

Groups bundle projects for access control — a collaborator can be granted a role scoped to a group rather than the whole team.

Events

group.created

New project group created.

group.updated

Group name or membership changes.

group.deleted

Group deleted; role-on-group falls back to default.

Event	Fires when
`group.created`	A new project group is created.
`group.updated`	Group name or project membership changes.
`group.deleted`	A group is deleted; collaborators with role-on-group fall back to their team default.

See the dedicated pages above for full payload, field reference, and caveats per event.

Example payload

{
  "id": "evt_01HX...",
  "type": "group.updated",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": null,
  "data": {
    "team_id": "tem_01HX...",
    "group": {
      "id": "grp_01HX...",
      "name": "Core Community",
      "project_ids": ["prj_01HX...", "prj_01HX..."]
    }
  }
}

Required abilities

Tokens subscribing to group.* events must carry group:view-any.