> ## Documentation Index
> Fetch the complete documentation index at: https://wabis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Contacts

> Keep your contacts and Google Contacts in step — push, pull, or both — with import rules, field mapping, and a sync history.

## What is this?

**Google Contacts** keeps your contacts and your Google Contacts in step. It's the **Google Contacts** page under **Google** in the sidebar (also reachable from **Channels → Google**). Contacts are matched by phone number the first time, then stay linked to their Google record.

> [!NOTE]
>
> Connect your Google account first — see [Google](https://wabis.mintlify.site/workspace/google/overview.md). The Google integration needs a plan that includes Google, and your platform administrator must have set up Google OAuth. Changing sync settings needs the Google edit permission. Some newer options show *Available after the next update of your workspace* until your workspace is updated.

## What can I do here?

* Turn the sync **On** or **Off**, choose a direction, and run **Sync now**
* Limit which contacts are pushed, and put them in a Google group
* Keep names, emails and mapped fields the same on both sides (**Two-way updates**)
* Turn Google groups into labels, and add labels to imported contacts
* Map Google's company, birthday and address to your custom fields
* Read the **History** of every run, including why contacts failed

## How to use it

The page shows four tiles — **Contacts synced** (pushed or imported in the last sync), **Last push**, **Last pull** and **Failed** (contacts that failed in the last sync) — above four tabs.

### Sync

1. Turn the sync **On**. Choose a direction:

   | Direction | What it does |
   | - | - |
   | **Push to Google** | Contacts saved here are added to Google Contacts. Nothing is imported from Google. This is the default |
   | **Pull from Google** | Contacts in Google Contacts are imported here. Nothing is sent to Google |
   | **Both** | Both of the above |

2. Click **Sync now** once to bring over the contacts you already have. A sync that's already running for the account shows *A sync is already running for this account*.

3. After that, new contacts sync automatically, and a scheduled run keeps changes flowing.

**Which contacts are pushed** — *Push only contacts with these labels*: leave empty to push every contact, or choose labels (a contact needs at least one). Optionally add pushed contacts to a **Google group** — pick one, or **Create group** to make a new one in Google Contacts.

**Two-way updates** — turn on **Update existing contacts** to copy a change from one side to the other after the first sync (names, emails and mapped fields; phone numbers are never changed). Choose what happens **when both sides changed**:

| Rule | Result |
| - | - |
| **Most recent change wins** | The side changed last is kept |
| **Google always wins** | The Google contact is kept and copied here |
| **This app always wins** | The contact here is kept and copied to Google |

Every conflict is listed in **History**.

> [!NOTE]
>
> Deleting a contact on one side **never** deletes it on the other. A Google contact whose phone number is in [Trash](https://wabis.mintlify.site/workspace/trash.md) here isn't imported again as a duplicate.

### Import rules

What is added to contacts imported from Google:

* **Labels** — added to a contact when it is first imported. Contacts that already exist aren't changed. If none are listed, create labels on the [Labels](https://wabis.mintlify.site/workspace/contacts/labels.md) page first.
* **Turn Google groups into labels** — each Google group of an imported contact becomes a label here; missing labels are created.

These rules are used when you pull from Google; with *Push to Google* only they have no effect.

### Fields

Choose which custom field holds each Google field — **Company** (the first organization), **Birthday** (copied as a full date; a birthday without a year isn't copied), and **Address** (the first address, as one line). Unmapped fields are **Not synced**. Name and email are always synced. Changing a mapping starts the comparison again on the next sync. Create custom fields first on the [Custom Fields](https://wabis.mintlify.site/workspace/contacts/custom-fields.md) page.

### History

The latest runs, each with its trigger (**Sync now**, **Scheduled**, or **New contacts**), status (**Running**, **Done**, **Failed**), and counts: pushed, imported, updated in Google, updated here, skipped and failed. Open a run to see the reasons, such as:

* *Google did not accept the contact*
* *Could not be saved here*
* *Could not be added to the Google group*
* *Not imported: a contact with this phone is in Trash*
* *Changed on both sides; the Google version / the version here was kept*

Only the first 100 problems of a run are listed.

## Troubleshooting / Technical Notes

* **No labels are listed.** Create labels first on the [Labels](https://wabis.mintlify.site/workspace/contacts/labels.md) page.
* **Contacts aren't appearing in Google.** Check the sync is **On**, the direction is **Push to Google** or **Both**, no label filter excludes them, then click **Sync now**.
* **Google contacts aren't showing here.** Set the direction to **Pull from Google** or **Both**, then click **Sync now**.
* **A contact failed.** Open **History** — each failure shows the reason.
* **Sync stopped working.** Use **Reconnect Google Account** on the [Google](https://wabis.mintlify.site/workspace/google/overview.md) page to grant access again.
* **I can't change settings.** You need the Google edit permission.

## Related docs

* [Google](https://wabis.mintlify.site/workspace/google/overview.md)
* [Contacts](https://wabis.mintlify.site/workspace/contacts/overview.md)
* [Labels](https://wabis.mintlify.site/workspace/contacts/labels.md)
* [Custom Fields](https://wabis.mintlify.site/workspace/contacts/custom-fields.md)
* [Google Sheets](https://wabis.mintlify.site/workspace/google/sheets.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.