---
title: "Gmail"
canonical: "https://layest.com/en/integrations/google-mail"
language: "en"
description: "Gmail is Google’s email service. Users can send messages, organize mail with labels and filters, and search by content or sender."
---

# Gmail

Gmail is Google’s email service. Users can send messages, organize mail with labels and filters, and search by content or sender.

## Authentication

**OAuth 2.0**: Authorize Layest on the provider’s sign-in page. The provider issues access tokens for the permissions you grant.

## Categories

- Communication

## Actions from Gmail

These supported actions can be set up out of the box and used by our agents.

- **Batch delete messages**: Permanently delete multiple Gmail messages by ID
- **Batch modify messages**: Add and remove labels on multiple Gmail messages at once.
- **Create draft**: Create a Gmail draft message from RFC 2822 MIME content.
- **Create filter**: Create a mailbox filter with match criteria and label actions.
- **Create label**: Create a new user label with visibility settings.
- **Create send as alias**: Create a custom send-as alias for the mailbox
- **Delete draft**: Delete an existing draft by draft ID
- **Delete filter**: Delete a mailbox filter by filter ID
- **Delete forwarding address**: Delete a forwarding address from Gmail settings.
- **Delete label**: Delete a user-created label
- **Delete message**: Permanently delete a Gmail message by ID.
- **Delete send as alias**: Delete a custom send-as alias from the mailbox.
- **Delete thread**: Permanently delete a Gmail thread and its messages.
- **Get attachment**: Retrieve a specific message attachment payload by attachment ID.
- **Get auto forwarding settings**: Retrieve the mailbox auto-forwarding configuration.
- **Get draft**: Retrieve a draft and its embedded message payload.
- **Get filter**: Retrieve a mailbox filter by filter ID.
- **Get forwarding address**: Retrieve a forwarding address configured for the mailbox.
- **Get imap settings**: Retrieve IMAP settings for the mailbox
- **Get label**: Retrieve a single Gmail label by label ID.
- **Get language settings**: Retrieve Gmail language settings for the mailbox.
- **Get message**: Retrieve a specific Gmail message with optional format selection.
- **Get pop settings**: Retrieve POP settings for the mailbox.
- **Get send as alias**: Retrieve a configured send-as alias
- **Get thread**: Retrieve a Gmail thread and its messages.
- **Get vacation settings**: Retrieve the mailbox vacation responder settings.
- **List drafts**: List drafts in the mailbox with pagination support.
- **List filters**: List mailbox filters configured for the authenticated user
- **List forwarding addresses**: List forwarding addresses configured for the mailbox.
- **List labels**: List built-in and user-created mailbox labels.
- **List messages**: List messages matching Gmail query and label filters.
- **List send as aliases**: List send-as aliases available for the mailbox.
- **List threads**: List conversation threads matching Gmail query and label filters.
- **List watch history**: List mailbox history records after a given history ID
- **Modify message**: Add and remove labels on a Gmail message
- **Modify thread**: Add and remove labels across a Gmail thread.
- **Send draft**: Send an existing draft message
- **Send message**: Send an email message through Gmail using raw MIME content.
- **Stop watch**: Stop Gmail push notification watch state for the mailbox.
- **Trash message**: Move a Gmail message to trash
- **Trash thread**: Move a Gmail thread to trash.
- **Untrash message**: Restore a trashed Gmail message to the mailbox.
- **Untrash thread**: Restore a trashed Gmail thread to the mailbox.
- **Update auto forwarding settings**: Update Gmail auto-forwarding behavior and disposition
- **Update draft**: Replace an existing draft with new MIME content.
- **Update imap settings**: Update IMAP enablement and visibility settings.
- **Update label**: Update a user-created label's name or visibility settings.
- **Update language settings**: Update the mailbox display language
- **Update pop settings**: Update POP access settings for the mailbox
- **Update send as alias**: Update send-as alias settings such as display name or reply-to.
- **Update send as smtp msa**: Update the SMTP MSA settings for a send-as alias.
- **Update vacation settings**: Update the mailbox vacation responder configuration.
- **Verify send as alias**: Trigger verification for a custom send-as alias
- **Watch mailbox**: Start Gmail push notifications for mailbox changes.

## Triggers from Gmail

Once configured in Nango, these sync templates can provide changes as triggers.

- **Filters**: Sync Gmail mailbox filters and their criteria or actions.
- **Labels**: Sync built-in and user-created Gmail labels.
- **Messages**: Sync Gmail messages with an initial backfill followed by history-based incremental updates.
- **Send as aliases**: Sync configured Gmail send-as aliases and alias settings
- **Threads**: Sync Gmail conversation threads with full message hydration
