Skip to content
Browse docslist_group_members

list_group_members

Read a page of a group’s current members. Reading changes nothing and starts no search.

Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false

Inputs#

FieldRequiredTypeMeaning
groupPublicIdyesstringExact group public ID: 32 lowercase hexadecimal characters, from list_groups or an authorized retained reference.
pageSizenointegerDefault 20 (also for 0), capped at 100. Negative or fractional values are invalid.
pageTokennostringOmit or use an empty string to start. For continuation, pass the preceding nextPageToken unchanged.

Result#

Each member has memberId, nullable displayName and email from the authorized group roster, role, isCurrentMember, isSearchable, membership joinedAt, and nullable sharedProfile (headline, location, linkedInUrl). The shared profile follows the member card visibility rule: hidden profiles are absent; inferred Gmail/member profiles require member confirmation, while public LinkedIn profiles may be visible without confirmation. These are the same membership summaries as get_group.memberPreview. Order is display name (email when unnamed, empty when neither is available), then member ID. Searchability is eligibility to search a network; it establishes neither suitability nor willingness. No contacts, private relationship context, photos, Gmail state, or connection controls are returned. Missing or inaccessible groups return unavailable.

Continuation#

nextPageToken is always present. Only an empty string means the list is complete. Continue even if a page is short or empty when its token is nonempty. Tokens expire after one hour and are bound to this operation, authenticated member, and group where applicable. Keep all arguments other than pageSize unchanged. Invalid, expired, or mismatched tokens return invalid_argument; restart without a token. Each page rechecks current membership. These are live reads, not a snapshot across pages. Within a tool budget, report partial coverage truthfully rather than claiming completion.

Example#

json
{
  "groupPublicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "pageSize": 20
}
json
{
  "members": [
    {
      "memberId": "00000000-0000-4000-a000-000000000003",
      "displayName": "Synthetic member",
      "email": "member@example.test",
      "role": "member",
      "isCurrentMember": true,
      "isSearchable": true,
      "joinedAt": "2026-10-09T00:00:00.000Z",
      "sharedProfile": {
        "headline": "Builds synthetic products",
        "location": null,
        "linkedInUrl": null
      }
    },
    {
      "memberId": "00000000-0000-4000-a000-000000000004",
      "displayName": "Synthetic colleague",
      "email": null,
      "role": "member",
      "isCurrentMember": false,
      "isSearchable": true,
      "joinedAt": "2026-10-09T00:00:00.000Z",
      "sharedProfile": {
        "headline": "Builds synthetic products",
        "location": null,
        "linkedInUrl": null
      }
    }
  ],
  "nextPageToken": ""
}