# Google Contacts

Connect Google Contacts as a data source: authorize with your Google account, the contacts it imports and keeps synchronized, how its fields map to Instasent attributes, and how consent is handled.

**Language:** en
**Audience:** platform
**TLDR:** Google Contacts is a native OAuth connector: you authorize Instasent with your Google account, granting read-only permission on your contacts, with no key to copy. It imports the people in your Google address book as contacts (name, email and phone) and keeps them current on a one-way periodic sync.
**Translation key:** platform.data-sources.connectors.google-contacts
**Search keywords:** Google Contacts, Google, contacts, address book, OAuth, connect Google Contacts, Google Contacts integration, Google Contacts consent, import contacts, Gmail contacts
**Related pages:** /platform/es/data-sources/connectors/google-contacts, /platform/en/data-sources/connectors, /platform/en/data-sources/connectors/google-sheets, /platform/en/data-sources/managing, /platform/en/consent
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/en/llms.txt
**This page:** https://docs.instasent.com/platform/en/data-sources/connectors/google-contacts/ (HTML) · https://docs.instasent.com/platform/en/data-sources/connectors/google-contacts.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/data-sources/connectors/google-contacts.md

Google Contacts is the native connector for your Google address book. Once authorized,
it imports your Google contacts into Instasent and keeps them synchronized
periodically, so the people in your Google account become part of your audience without
any manual export.

## How to connect

Google Contacts is a **[native OAuth connector](/platform/en/data-sources/connectors#native-oauth)**:
you authorize Instasent with your Google account and grant the requested permission in
Google's own window, and you're connected. Instasent only requests permission to **read
your Google contacts** — nothing else. There's no key to create or copy anywhere.

#### 1. Add the data source

In **Data sources**, select **Add data source** and choose **Google Contacts** from
the Integrations section.

#### 2. Connect your Google account

Select **Connect Google account** to open Google's authorization window and approve
the requested access. Only read permission for your Google contacts is requested.

#### 3. Initial import

Google returns you to Instasent and the source moves to connected. The connector
imports your existing contacts, then re-reads them periodically to pick up changes.

{/* IMG-PENDING: Google OAuth authorization screen for Contacts */}

![The Google Contacts connector page with its description, what it imports, and the contact fields it maps, with Connect Google Contacts to start](/platform/en/data-sources/images/google-contacts--1-connect.png)
*The Google Contacts connector page: what it brings into Instasent and the contact fields it maps, with Connect Google Contacts to start.*

## What it syncs

- **Contacts** — the people in your Google address book, with their name, email and
  phone.

The sync is one-way, **from Google into Instasent**, and runs periodically. Contacts
unify with the rest of your audience by email and phone, the same as any source — see
[unification](/platform/en/data-sources/managing#how-unification-works).

## Field mapping

Google contact fields map to the matching Instasent attributes — email to `_email`,
phone to `_phone_mobile`, name fields to their attributes. As with any source you
confirm the mapping on setup; see
[field mapping](/platform/en/data-sources/managing#field-mapping).

## Consent mapping

{/* VERIFY: the exact Google Contacts → Instasent consent mapping is not yet confirmed. The mapping below applies the consent golden rule; confirm against the connector's actual behaviour before treating it as definitive. */}

Google Contacts does not carry a marketing subscription status, so map it to Instasent's
marketing-preference attribute (`_accepts_marketing_*`) following the consent golden
rule:

| Google status | Instasent value | Meaning                               |
| ------------- | --------------- | ------------------------------------- |
| Opted in      | `true`          | Accepted marketing                    |
| No status     | `null`          | No preference — never opted in or out |
| Opted out     | `false`         | Actively declined marketing           |

Only an **active opt-out** becomes `false`. A contact with no recorded status maps to
**no preference** (`null`), never to `false`. For what these values mean for who receives
a campaign, see [Consent](/platform/en/consent/marketing-preference-vs-suppression).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.