List Contact Groups

google_contacts.list_contact_groups
ActionCRM & salesconnection required

Calls the People API GET /contactGroups.

List contact groups (labels) — how to find a group's id.

Connection

Required
Yes — the node will not save without one
Auth type
OAuth 2.0
Providers
Google Contacts
Secret shape
{"client_id", "client_secret", "refresh_token"}
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
max_results
How many groups to collect in total.
numberNo100≥ 1—
page_token
Resume from a previous run's next_page_token.
stringNo———

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "max_results": 100
}

Output

One shape.

result

FieldTypeExample
groups
Each: resource_name (contactGroups/...), name, formatted_name, group_type (USER_CONTACT_GROUP or SYSTEM_CONTACT_GROUP), member_count, etag.
array—
count
How many groups were returned.
number—
truncated
True when the budget ran out.
boolean—
next_page_token
Cursor to resume from.
string—
{
  "count": 0,
  "groups": [],
  "next_page_token": "",
  "truncated": false
}

See List Contact Groups run in a workflow.

In a technical demo we add the Google Contacts connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.