Book a demo

Modify Group Members

google_contacts.modify_group_members
ActionCRM & salesconnection required

Calls the People API POST /contactGroups/{group}/members:modify.

Add contacts to a contact group, or take them out of it.

Ask about Google ContactsAll Google Contacts nodes

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

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

FieldTypeRequiredDefaultConstraintsExample
group_resource_name
Group id from google_contacts.list_contact_groups, e.g. contactGroups/abc123.
stringYes———
add
Contact ids to add — a list, or ids separated by commas.
arrayNo—array of string["people/c123456789"]
remove
Contact ids to remove — a list, or ids separated by commas.
arrayNo—array of string—
  • At least one of add, remove must be set.

Example configuration

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

{
  "add": [
    "people/c123456789"
  ]
}

Output

One shape.

result

FieldTypeExample
ok
boolean—
group_resource_name
string—
added
Contacts asked to be added.
array—
removed
Contacts asked to be removed.
array—
not_found
Contacts Google could not find. Google answers 200 for these, so check this rather than trusting ok.
array—
cannot_remove_last_group
Contacts left in no group at all, which Google refuses.
array—
{
  "added": [],
  "cannot_remove_last_group": [],
  "group_resource_name": "",
  "not_found": [],
  "ok": false,
  "removed": []
}

Notes

  • Adding a contact that is already a member is a no-op, so this node is safe to re-run.

Related Google Contacts nodes

See Modify Group Members 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.

Book a technical demoTalk to sales