ceven

Googlecontacts

Syncs your professional network across SaaS tools, updates contact details from email signatures, and manages group memberships based on CRM stage changes.

Try Googlecontacts in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Googlecontacts integration

    • Describe the outcome and Ceven picks the right Googlecontacts calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Googlecontacts data, across all 24 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Googlecontacts access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Googlecontacts, when, and on whose behalf.
    • The agent pauses and asks when Googlecontacts is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Googlecontacts.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Googlecontacts action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Googlecontacts, and when to use it.

Create Contact
Use this when you need to add a new person to the authenticated user Google Contacts list.
Update Google Contact
Use this to modify specific details like name, email, or phone for an existing contact person.
Search Contacts
Query contacts by name, nickname, email, phone, or organization to find a specific person.
List Connections
Pull a paginated list of all contacts with options for sorting and incremental sync.
Create Contact Group
Use this to create a new unique group for organizing contacts into categories.
Modify Contact Group Members
Add or remove specific contact resource names from a designated contact group.
Delete Google Contact
Permanently remove a contact person from the user Google Contacts list.
Get Person
Pull detailed information for a specific person using their unique resource name.
List Contact Groups
Retrieve all contact groups including system groups like Starred and My Contacts.
Batch Create Contacts
Create up to 200 new contacts in a single call to avoid hitting rate limits during imports.
Search Domain Directory People
Query the Google Workspace domain directory for company profiles and colleagues.
List Other Contacts
Pull contacts that Google auto created from email interactions but are not in a group.
Batch get contact groups
Get a list of contact groups owned by the authenticated user by specifying a list of contact group resource names. Use when you need to retrieve details for specific contact groups, such as getting group metadata, member counts, or group na
Batch Update Google Contacts
Update a batch of contacts in Google Contacts and return the updated contact data. Use this action when you need to modify multiple contacts at once, such as: - Updating names, phone numbers, or email addresses for several contacts - Making
Copy Other Contact to My Contacts
Copies an Other contact to a new contact in the user's myContacts group. Use this action when you need to save an existing "Other contact" (from Google's contact suggestions) to your permanent contacts in the myContacts group. Mutate reques
Delete contact group
Deletes an existing contact group owned by the authenticated user by specifying the contact group resource name. This action is irreversible, once deleted, the contact group cannot be recovered. Use this action when you need to remove a con
Delete Contact Photo
Delete a contact's photo from Google Contacts. Use when you need to remove a profile picture from a specific contact. This action is irreversible, once the photo is deleted, it cannot be recovered. Mutate requests for the same user should b
Batch Delete Google Contacts
Delete a batch of contacts from Google Contacts. Any non contact data will not be deleted. Use this action when you need to permanently remove multiple contacts from the user's Google Contacts list at once. This action is irreversible, the
Batch get people
Batch retrieves information about multiple people from Google Contacts. Use this action when you need to fetch contact information for several people in a single API call rather than making individual requests per person. This improves effi
Get Contact Group
Retrieves a specific contact group owned by the authenticated user by specifying the contact group resource name. Use when you need to get details about a specific contact group, including its name, member count, and metadata. This is a rea
List Directory People
Lists domain profiles and domain contacts in the authenticated user's domain directory. Use when you need to retrieve directory information for all users in a Google Workspace domain, including their contact details like names, emails, and
Search Other Contacts
Searches other contacts from Google People API that match a query string. Other contacts are contacts not in any contact group, typically auto created from interactions like emails sent or received. This action searches across names, email
Update Contact Group
Update the name of an existing contact group owned by the authenticated user. Use this action when you need to rename a contact group or update its metadata. Attempting to create a group with a duplicate name will return an HTTP 409 error.
Update Contact Photo
Update a contact's photo. Use when you need to change or set the profile picture for an existing Google Contact. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures. The photo should be prov

24 actions · scroll to see them all

Frequently asked questions

Ceven uses OAuth 2.0 to request specific scopes from your Google account. We typically request the people.readwrite scope which allows the agent to see and modify your contacts and groups. This process happens through the official Google consent screen where you can see exactly what data is being accessed. We never store your Google password. Instead we store an encrypted refresh token that allows us to request a new access token whenever a workflow needs to run. You can revoke this access instantly through your Google Account security settings under Third party apps with account access.
Yes. Google maintains a category called Other contacts which contains people you have interacted with via Gmail or Calendar but have not explicitly saved. Ceven can search and list these Other contacts and can even move them into your main My Contacts group if a workflow determines they are important. This is useful for automatically saving a lead who has emailed you three times but was never formally added to your address book by a human.
Google Contacts does not have a built in unique constraint on email addresses at the API level which means you can accidentally create multiple records for one person. To prevent this Ceven runs a search check before every create action. The agent searches for the email address or phone number first. If a match is found it will perform an update to the existing record rather than creating a duplicate. This ensures your address book stays clean even when syncing from multiple different SaaS sources.
Yes. The Google People API imposes strict rate limits on how many requests can be made per user per second. If you try to update thousands of contacts individually you will likely hit a 429 Too Many Requests error. To solve this Ceven uses the batch create and batch update endpoints whenever possible. These allow us to group up to 200 operations into a single API call. This significantly reduces the number of requests and ensures that large migrations from a CRM to Google Contacts finish without being throttled by Google.
Ceven can read from your domain directory using the search domain directory people action. This allows the agent to find colleagues and their professional details within your Google Workspace organization. However it is important to note that directory profiles are usually managed by your IT administrator at the domain level. While Ceven can read this data to help you find a coworker it cannot modify the official domain directory profile because those permissions are restricted to Workspace admins.
Ceven treats Google Contact groups as tags. When you define a workflow you can tell the agent to add a contact to a group based on a trigger. For example if a deal in your CRM is marked as Closed Won the agent will first ensure the contact exists and then call the modify contact group members action. This effectively tags the person in your Google account. If the deal later moves to a different stage the agent can remove them from that group and add them to another one automatically.
Ceven cannot recover a contact once the delete action has been successfully called through the API. Google Contacts does not provide a trash or undo endpoint via the People API for programmatic deletions. Because of this Ceven implements a safety check for any workflow involving the delete action. The agent will typically log the deletion and can be configured to archive the contact details into a Google Sheet or a database before the permanent deletion occurs to ensure you have a backup.
Absolutely. Since Ceven acts as the orchestration layer it can read data from Google Contacts and push it into any other connected tool. You can build a workflow that pulls a list of contacts from a specific Google group and then adds those same people to a Mailchimp audience or a Zoom meeting invite. The agent handles the data mapping between the Google People API format and the destination app format so you do not have to manually map fields like first name or email address.

Alternatives to Googlecontacts

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Microsoft Outlook logoMicrosoft OutlookHubSpot logoHubSpotZoho Contacts logoZoho Contacts

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Googlecontacts and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free