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

# 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="Screenshot of the MESA Gmail step connection setup using MESA&#x27;s Google App. Spotlight the Sign in with Google button."><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="Screenshot of the Google account authentication permissions prompt during Gmail integration setup. Spotlight the checkboxes to select all available permissions."><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 %}
