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

# Gmail

> Sync emails with Arya records, send from Arya, track opens and replies.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/gmail/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=a634a4bfcb809832052023ea4820155d" alt="Gmail integration tile in Arya settings" width="1200" height="720" data-path="images/integrazioni/gmail/shared/tile.svg" />
</Frame>

## What it does

Connect your Gmail inbox to Arya to auto-track all emails exchanged with contacts and deals. Send emails directly from Arya, see threads in the record timeline, receive notifications on replies and opens. Supports Google Workspace and personal Gmail.

## Prerequisites

<Note>
  * Active account with Gmail
  * **Admin** or **Manager** role on Arya to connect
  * OAuth authorisation (or API key, where applicable)
</Note>

## Connect Gmail

<Steps>
  <Step title="Go to Settings → Integrations">Find **Gmail** in the gallery and click **Connect**.</Step>
  <Step title="Authorise via OAuth">Opens Gmail login page. Grant requested permissions.</Step>
  <Step title="Confirm in Arya">Arya tests the connection. If OK, you see "Connected" in green.</Step>
  <Step title="Configure preferences (optional)">Sync frequency, filters, field mapping. From **Settings → Integrations → \[Gmail] → Configure**.</Step>
</Steps>

## What syncs

| Direction    | Entity                                           |
| ------------ | ------------------------------------------------ |
| Gmail → Arya | Sent/received emails → contact and deal timeline |
| Arya → Gmail | Emails composed in Arya sent via Gmail           |
| Gmail → Arya | Email signature imported as workspace signature  |

## Use in workflows

Once connected, Gmail appears as an action in the [workflow builder](/en/automations/workflow-builder). You can:

* Trigger workflows from Gmail events
* Use Gmail as an action (e.g. create record, send message)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorisation error">
    Expired or revoked token. Disconnect and reconnect.
  </Accordion>

  <Accordion title="Slow or failed sync">
    Check service API quota (rate limit). Reduce frequency if exceeding quota.
  </Accordion>

  <Accordion title="Data not synced">
    Verify field mapping and filters. Try manual sync from **⋯ → Sync now**.
  </Accordion>

  <Accordion title="Duplicate errors">
    Arya uses unique keys for matching. Configure key (email, external ID) in **Settings → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnect

<Warning>
  Disconnection immediately stops synchronisation. Already-imported data stays in the workspace.
</Warning>

<Steps>
  <Step title="Go to Settings → Integrations">Find the Gmail card.</Step>
  <Step title="Click Disconnect">Confirm. Access token is revoked.</Step>
</Steps>