> For the complete documentation index, see [llms.txt](https://help.zaapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zaapi.com/integrations/gmail/how-to-connect.md).

# How to connect

{% hint style="warning" %}
You must have a Gmail account in order to access this integration. This can either be a personal Gmail account (i.e <acme@gmail.com>) or a Google Workspace account with a custom domain name (i.e <user@acme.com>).
{% endhint %}

1. Go to the **Integrations** Area – Navigate to Settings > Integrations in Zaapi.
2. Click "**Connect**" – Locate the Gmail card within the integrations list and click the + Connect button.
3. Choose an account – A Google sign-in window will appear. Select the Google Account you wish to connect to Zaapi.
4. Grant Access – Review the permissions requested by Zaapi and click Continue to authorize the connection.
5. Configure Import Settings – You will be directed back to Zaapi to configure the "Gmail import" options:
   * Import email history and labels: Toggle this ON to import your last 7 days of history.
   * Select Categories: Check the boxes for the specific email folders you want to sync (e.g., INBOX, SPAM, CATEGORY PROMOTIONS, etc.).
     * After initial integration, only emails from the selected categories will appear in the Zaapi inbox. All emails will still be visible from within the native Gmail account.
6. Finish Setup – Once you have selected your preferences, click Confirm to complete the integration.