rocketkind
Productivity

Google Contacts

Google Contacts is the address book behind a Google or Google Workspace account, served by Google's People API.

Authentication

  • OAuth 2.0

Actions

Generic API request. Call any Google Contacts API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path, query and body are yours to fill.

  • Batch create contactsDestructiveCreate up to 200 contacts in one call instead of one createcontact round trip each.
  • Batch delete contactsDestructiveDelete up to 500 contacts in one call by listing their resource names, instead of one deletecontact round trip each.
  • Batch get contact groupsDestructiveRead several contact groups in one call by listing their contactGroups/{id} resource names, up to 200 per request.
  • Batch get peopleDestructiveRead several people in one call by listing their resource names, instead of one getperson round trip each.
  • Batch update contactsDestructiveUpdate up to 200 existing contacts in one call, keyed by resource name.
  • Copy other contact to My ContactsPromote an auto-collected "Other contact" into a real contact in the user's contactGroups/myContacts group, so it becomes editable and shows up in listconnections.
  • Create contactCreate a contact in the authenticated user's address book from semantic fields — names, emails, phone numbers, addresses, organizations and the rest are assembled into the Person body for you.
  • Create contact groupCreate a contact group owned by the authenticated user, so contacts can be filed under a label.
  • Delete contactDestructiveDelete a contact from the authenticated user's address book.
  • Delete contact groupDestructiveDelete a contact group the authenticated user owns.
  • Delete contact photoDestructiveRemove the photo the authenticated user set on a contact, so the contact falls back to whatever photo its Google profile provides.
  • Get contact groupRead one contact group the authenticated user owns, addressed by its contactGroups/{id} resource name.
  • Get personRead one person by resource name.
  • List connectionsEnumerate the authenticated user's own saved contacts — the address book, which Google calls the user's connections.
  • List contact groupsList the contact groups the authenticated user owns — both the system groups Google ships (myContacts, starred, family, friends, coworkers) and the user's own groups.
  • List directory peopleEnumerate the Google Workspace domain directory the authenticated user belongs to — the organisation's user profiles and its shared external contacts, not the user's own address book.
  • List other contactsList the authenticated user's "Other contacts" — the addresses Google auto-collects from interactions such as sent mail, which live outside the address book and outside every contact group.
  • Modify contact group membersDestructiveAdd contacts to a contact group and/or remove them from it, in one call.
  • Search contactsPrefix-search the authenticated user's saved contacts.
  • Search directory peoplePrefix-search the Google Workspace domain directory — colleagues' profiles and the organisation's shared external contacts, not the user's own address book.
  • Search other contactsPrefix-search the authenticated user's "Other contacts" — the auto-collected addresses that are not in the address book.
  • Update contactDestructiveUpdate an existing contact from semantic fields, which are assembled into the Person body for you.
  • Update contact groupDestructiveRename an existing contact group the authenticated user owns, or replace its client data.
  • Update contact photoDestructiveSet or replace the photo on a contact in the authenticated user's address book.

Triggers

  • New or updated contactStarts when a contact in the connected account's address book is added, edited or deleted.
  • New or updated other contactStarts when an address Google auto-collected from the connected account's interactions is added, changed or removed.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.