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#
| Field | Required | Type | Meaning |
|---|---|---|---|
groupPublicId | yes | string | Exact group public ID: 32 lowercase hexadecimal characters, from list_groups or an authorized retained reference. |
pageSize | no | integer | Default 20 (also for 0), capped at 100. Negative or fractional values are invalid. |
pageToken | no | string | Omit 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#
{
"groupPublicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"pageSize": 20
}
{
"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": ""
}