--- title: Google Contacts API Integration on Truto slug: googlecontacts category: Default canonical: "https://truto.one/integrations/detail/googlecontacts/" --- # Google Contacts API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified Search API - **Search** — Search endpoint for all the apps. ## How it works 1. **Link your customer's Google Contacts account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Google Contacts.** The Proxy API is a 1-to-1 mapping of the Google Contacts API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync CRM contacts to users' Google address books** — SaaS CRMs can push lead and customer records into their users' Google Contacts so that caller ID on mobile devices shows prospect names and companies. This keeps sales reps from missing high-value calls when they're away from their desk. - **Auto-populate client records from Google Contacts** — Invoicing, accounting, or project management tools can let users import contacts directly from their Google address book instead of typing them in manually. This eliminates duplicate data entry and reduces errors in billing addresses and email fields. - **Enrich meeting context with contact metadata** — AI meeting assistants and note-taking tools can cross-reference calendar invite attendees against Google Contacts to surface job titles, company names, and phone numbers — giving users richer context before and after every call. - **Mine 'Other Contacts' to seed prospect lists** — Sales engagement and recruiting platforms can surface the shadow network of people a user has emailed but never explicitly saved, automatically populating pipelines or candidate databases without manual data entry. - **Search across a user's network for real-time autocomplete** — Any SaaS product that needs a 'pick a person' field — task assignment, deal association, invoice recipients — can query Google Contacts in real time via the Unified Search API to power fast, familiar autocomplete experiences. ## What you can build - **Contact search autocomplete** — Build a type-ahead search field that queries your users' Google Contacts in real time via the Unified Search API, letting them find and select contacts without leaving your app. - **One-click client import from Google Contacts** — Let users browse or search their Google address book and import selected contacts — complete with name, email, phone, company, and job title — directly into your app's database. - **Caller ID sync for mobile sales teams** — Push CRM records into your users' Google Contacts so that incoming calls from prospects display the contact's name and company on the native phone dialer. - **Label-based segmented sync** — Allow users to select specific Google Contacts labels (e.g., 'Active Clients' or 'VIP Leads') and sync only those subgroups into your platform for targeted workflows. - **Meeting attendee enrichment** — Cross-reference calendar invite email addresses against Google Contacts to automatically attach job titles, organizations, and phone numbers to meeting participants in your app. - **Shadow network discovery** — Surface contacts from the user's 'Other Contacts' list — people they've emailed but never saved — to auto-populate prospect or candidate pipelines. ## FAQs ### Which API does the Google Contacts integration use? It uses the Google People API, which replaced the legacy Google Contacts API. This is the current, supported interface for reading and writing contact data in Google Workspace. ### What authentication method is required for Google Contacts? Google Contacts uses OAuth 2.0. Truto handles the full OAuth flow — consent screens, token exchange, and refresh — so your end users simply authorize access through the standard Google sign-in prompt. ### Does the Google People API support webhooks for real-time change notifications? No. Unlike the Gmail API, the Google People API does not offer native push notification webhooks. Change detection is typically handled via scheduled polling using the API's syncToken mechanism, which returns only contacts created, updated, or deleted since the last sync. ### What contact fields are available through the integration? The Google People API exposes names, email addresses, phone numbers, organizations (company and job title), contact group memberships (labels), physical addresses, user-defined custom fields, and notes, among other fields. ### Are there specific Truto Unified API resources available for Google Contacts today? Google Contacts is currently supported through the Unified Search API for search operations. Additional tools and unified API resources can be built on request to cover specific workflows like batch sync, contact creation, or label management. ### What are the rate limits for the Google People API? Google enforces per-user and per-project quotas on the People API. Batch endpoints (batchCreateContacts, batchUpdateContacts) help optimize throughput. Truto manages pagination and respects rate limits automatically, so you don't need to handle backoff logic yourself.