# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.zaapi.com/integrations/gmail/how-to-connect.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
