# Gmail

## Connection

Connections provide secure access to the integrated app that you use in a MESA workflow. Your Gmail connection securely links your workflows with your Google account.

When you're setting up your first workflow with Gmail, you'll need to create a connection through MESA's Google App or your own custom Google App. Click on the Sign in with Google button to finish the process.

<figure><img src="/files/QI5uONWdSuBPwJr6tZRi" alt=""><figcaption></figcaption></figure>

You will need to check all boxes that are available when prompted during authentication for the integration to work properly.

<figure><img src="/files/YlubjOpYC9JYZd1DolNg" alt=""><figcaption></figcaption></figure>

## Important Details

There are different limits and maximum limitations depending on your account type.

* **Free Gmail account:** If you use a free Gmail account, you are limited to sending a maximum of 500 emails in a 24-hour period, and a maximum of 100 addresses per email.
* **Paid Google Workspace account:** If you use a paid Google Workspace account, you are limited to sending a maximum of 2,000 emails in a 24-hour period.
* **Free trial period:** Anyone using the free trial period for a Google Workspace account is subject to 500-email maximums until you convert their account to the full paid version and complete a 60-day waiting period.

{% hint style="danger" %}
**Note:** If you exceed any of the above limits, **your account can be suspended for up to 24 hours.**
{% endhint %}


---

# 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://docs.getmesa.com/connect/gmail.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.