Google Contacts
Also an agent toolGoogle Contacts integration (People API v1 — people, connections, contactGroups, contactGroups.members, otherContacts). Single-host connector. Polling trigger on the user's connections list using a 7-day sync token — the People API has no native signed webhook (incremental sync via syncToken is the only change-notification mechanism).
17 actions · 1 triggers
The Google Contacts integration lets you connect Google Contacts to your automations with 17 actions and 1 triggers — and every action is also a tool an AI agent can call. Examples: List Contacts, Get Person, Get People (Batch), Search Contacts, Create Contact. No blank-canvas wiring — connect it and use it in your workflows.
Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.
Triggers 1
Events in Google Contacts that can start a workflow.
New or updated contact
Polls people.connections.list for contact changes using a 7-day opaque sync token. First run requests a token (requestSyncToken=true); subsequent runs pass it back as syncToken and receive only changed/added/deleted contacts.
Actions 17
What Zervanor can do in Google Contacts.
ContactGroups6
List Contact Groups
List all contact groups owned by the user, including system groups (People API: contactGroups.list).
Get Contact Group
Get one contact group (People API: contactGroups.get). maxMembers controls member-name truncation.
Create Contact Group
Create a new user-defined contact group (People API: contactGroups.create).
Update Contact Group
Rename an existing user group (People API: contactGroups.update, PUT). Requires updateGroupFields.
Delete Contact Group
Delete a user group (People API: contactGroups.delete). The deleteContacts flag optionally deletes members too.
Modify Group Members
Add and/or remove contacts from a contact group in a single call (People API: contactGroups.members.modify). Max 500 of each. Colon-suffixed custom method.
People3
List Contacts
List the authenticated user's contacts (People API: people.connections.list; resourceName must be people/me). Page-token paginated; supports incremental sync via syncToken (7-day token). Polling source for the new/updated-contact trigger. Requires personFields.
Update Contact
Update an existing contact (People API: people.updateContact, PATCH). Requires updatePersonFields and the contact's current etag (optimistic concurrency). Colon-suffixed custom method.
Delete Contact
Delete a single contact (People API: people.deleteContact, DELETE). Returns an empty body on success. CLEANUP action for the create->delete test pair. Colon-suffixed custom method.
OtherContacts2
List Other Contacts
List "Other contacts" (auto-collected, ungrouped) (People API: otherContacts.list). Requires readMask. Supports incremental sync via syncToken.
Copy Other Contact
Copy an "other contact" into the myContacts group, promoting it to an editable contact (People API: otherContacts.copyOtherContactToMyContactsGroup). Colon-suffixed custom method.
ContactGroups:BatchGet1
Get Contact Groups (Batch)
Get multiple contact groups by resource name in one call (People API: contactGroups.batchGet).
Other1
Get Person
Get a single person by resource name (People API: people.get). resourceName="people/me" returns the authed user; "people/c<ID>" returns a contact. Requires personFields. Safe READ test target.
OtherContacts:Search1
Search Other Contacts
Search "Other contacts" by query (People API: otherContacts.search). Requires readMask.
People:BatchGet1
Get People (Batch)
Get up to 200 people by resource name in one call (People API: people.getBatchGet). GET with resourceNames repeated in the query string. Requires personFields.
People:CreateContact1
Create Contact
Create a single new contact from a Person body (People API: people.createContact). Returns the created Person including its resourceName (people/c<ID>) used for cleanup. Colon-suffixed custom method.
People:SearchContacts1
Search Contacts
Search the user's grouped contacts by prefix query against names, nicknames, emails, phones, and organizations (People API: people.searchContacts). Requires readMask.
Nothing matches your search.
Automations using Google Contacts
Build your own automation with Google Contacts in the visual builder.
Frequently asked questions
What can I automate with Google Contacts?
17 actions are available — for example: List Contacts, Get Person, Get People (Batch), Search Contacts, Create Contact, and more.
Which Google Contacts events can start a workflow?
1 triggers — for example: New or updated contact.
Can Google Contacts be used as an AI agent tool?
Yes. Every Google Contacts action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.
How is the Google Contacts integration modelled?
Google Contacts is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.