# Fiche connecteur Gmail
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Gmail
URL : https://get-bruno.com/features/connectors/gmail
Référence texte : https://get-bruno.com/features/connectors/gmail/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Communication
Description : Gmail est un service de messagerie de Google pour consulter, chercher, organiser et envoyer des e-mails dans une boîte personnelle ou professionnelle. Le connecteur expose des actions sur les messages, les libellés, les filtres, les signatures et la recherche de conversations.
Authentification : OAuth
Présentation : Gmail est un service de messagerie de Google pour consulter, chercher, organiser et envoyer des e-mails dans une boîte personnelle ou professionnelle. Le connecteur expose des actions sur les messages, les libellés, les filtres, les signatures et la recherche de conversations.
Usage : Retrouver un fil client et préparer une réponse
Exemple de demande : Je veux retrouver les derniers e-mails d’Atelier Martin sur le devis de mars 2026 et préparer une réponse dans le même fil.
Résultat attendu : Retourne les messages trouvés avec sujet, expéditeur, date et extrait, puis permet d’ouvrir le fil complet pour préparer une réponse liée au bon message.
À préciser : Nom ou adresse du client à rechercher ; Période ou mot-clé du sujet ; Besoin de lire un message précis ou tout le fil
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gmail/actions/find-email ; https://pipedream.com/apps/gmail/actions/list-thread-messages
Usage : Classer un e-mail dans un dossier de suivi
Exemple de demande : Je veux ajouter le libellé Clients/Atelier Martin à l’e-mail de confirmation reçu ce matin.
Résultat attendu : Applique le libellé demandé au message ciblé, à condition que le libellé existe ou ait été créé avant.
À préciser : Identifiant du message ou critère de recherche ; Nom du libellé à appliquer ; Vérification que le libellé existe déjà ou doit être créé
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gmail/actions/list-labels ; https://pipedream.com/apps/gmail/actions/create-label ; https://pipedream.com/apps/gmail/actions/modify-labels ; https://pipedream.com/apps/gmail/actions/remove-label-from-email
Usage : Créer un envoi automatique pour les avis de réunion
Exemple de demande : Je veux créer un filtre pour envoyer au libellé Réunions les messages de planning@ateliermartin.fr qui contiennent le mot compte-rendu.
Résultat attendu : Crée un filtre Gmail qui s’appliquera aux futurs messages correspondant à tous les critères fournis.
À préciser : Adresse ou règle d’expéditeur ; Critère de contenu ou de sujet ; Action à appliquer au courrier entrant
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/gmail/actions/list-filters ; https://pipedream.com/apps/gmail/actions/create-filter
Limites propres au service : Les recherches renvoient d’abord des métadonnées, et le corps complet n’est disponible que si le format demandé l’autorise. Les filtres n’agissent que sur les messages reçus après leur création. Les libellés système comme INBOX, SENT, SPAM ou TRASH ne peuvent pas être supprimés. Les pièces jointes nécessitent un message lu en format complet avant téléchargement.
Vocabulaire français : Ajouter un libellé à un e-mail — Ajoute un ou plusieurs libellés à un message Gmail ciblé. (https://pipedream.com/apps/gmail/actions/add-label-to-email)
Vocabulaire français : Archiver un e-mail — Retire un message de la boîte de réception sans le supprimer. (https://pipedream.com/apps/gmail/actions/archive-email)
Vocabulaire français : Archiver plusieurs e-mails — Archive plusieurs messages Gmail en une seule opération. (https://pipedream.com/apps/gmail/actions/bulk-archive-emails)
Vocabulaire français : Créer un brouillon — Crée un brouillon non envoyé dans la boîte Gmail authentifiée, à partir d’un contenu prêt à envoyer ou à répondre. (https://pipedream.com/apps/gmail/actions/create-draft)
Vocabulaire français : Créer un filtre — Crée une règle Gmail qui applique automatiquement une action aux futurs messages correspondant aux critères fournis. (https://pipedream.com/apps/gmail/actions/create-filter)
Vocabulaire français : Créer un libellé — Crée un nouveau libellé utilisateur dans la boîte Gmail authentifiée et renvoie son identifiant. (https://pipedream.com/apps/gmail/actions/create-label)
Vocabulaire français : Supprimer un e-mail — Déplace le message indiqué vers la corbeille. (https://pipedream.com/apps/gmail/actions/delete-email)
Vocabulaire français : Supprimer un filtre — Supprime définitivement un filtre Gmail existant à partir de son identifiant. (https://pipedream.com/apps/gmail/actions/delete-filter)
Vocabulaire français : Supprimer un libellé — Supprime définitivement un libellé utilisateur et l’enlève de tous les messages concernés. (https://pipedream.com/apps/gmail/actions/delete-label)
Vocabulaire français : Télécharger une pièce jointe — Télécharge une pièce jointe Gmail vers /tmp et renvoie son chemin ainsi que ses métadonnées. (https://pipedream.com/apps/gmail/actions/download-attachment)
Vocabulaire français : Trouver des e-mails — Recherche dans la boîte Gmail avec la syntaxe de requête native et renvoie les messages correspondants. (https://pipedream.com/apps/gmail/actions/find-email)
Vocabulaire français : Obtenir l’utilisateur courant — Renvoie le nom, l’adresse e-mail et quelques statistiques de la boîte du compte authentifié. (https://pipedream.com/apps/gmail/actions/get-current-user)
Vocabulaire français : Obtenir un alias d’envoi — Renvoie un alias d’envoi Gmail précis pour le compte authentifié. (https://pipedream.com/apps/gmail/actions/get-send-as-alias)
Vocabulaire français : Obtenir un fil de discussion — Récupère une conversation Gmail entière à partir de son identifiant de fil. (https://pipedream.com/apps/gmail/actions/list-thread-messages)
Vocabulaire français : Lister les filtres — Liste tous les filtres configurés dans les paramètres Gmail du compte authentifié. (https://pipedream.com/apps/gmail/actions/list-filters)
Vocabulaire français : Lister les libellés — Liste tous les libellés de la boîte Gmail, y compris les libellés système et utilisateur. (https://pipedream.com/apps/gmail/actions/list-labels)
Vocabulaire français : Lister les options d’envoi en tant que délégataire — Récupère les options disponibles pour le champ d’envoi en tant que délégataire. (https://pipedream.com/apps/gmail/actions/list-delegate-options)
Vocabulaire français : Lister les alias d’envoi — Liste tous les alias d’envoi disponibles pour le compte authentifié. (https://pipedream.com/apps/gmail/actions/list-send-as-aliases)
Vocabulaire français : Lister les options de signature — Récupère les options disponibles pour le champ de signature. (https://pipedream.com/apps/gmail/actions/list-signature-options)
Vocabulaire français : Modifier les libellés — Ajoute ou retire des libellés sur un message Gmail existant. (https://pipedream.com/apps/gmail/actions/modify-labels)
Vocabulaire français : Retirer un libellé d’un e-mail — Retire un ou plusieurs libellés d’un message ciblé. (https://pipedream.com/apps/gmail/actions/remove-label-from-email)
Vocabulaire français : Envoyer un e-mail — Envoie un nouveau message ou répond à un fil existant depuis le compte Gmail authentifié. (https://pipedream.com/apps/gmail/actions/send-email)
Vocabulaire français : Mettre à jour la signature d’un e-mail dans une organisation — Met à jour la signature d’une adresse e-mail spécifique dans une organisation avec délégation de domaine Google Cloud. (https://pipedream.com/apps/gmail/actions/update-org-signature)
Vocabulaire français : Mettre à jour la signature de l’adresse principale — Met à jour la signature de l’adresse e-mail principale du compte. (https://pipedream.com/apps/gmail/actions/update-primary-signature)
Vocabulaire français : Nouvelle pièce jointe reçue — Déclenche un événement pour chaque pièce jointe reçue dans un message entrant. (https://pipedream.com/apps/gmail/triggers/new-attachment-received)
Vocabulaire français : Nouvel e-mail correspondant à une recherche — Déclenche un événement quand un e-mail entrant correspond aux critères de recherche. (https://pipedream.com/apps/gmail/triggers/new-email-matching-search)
Vocabulaire français : Nouvel e-mail reçu — Déclenche un événement à chaque nouveau message reçu. (https://pipedream.com/apps/gmail/triggers/new-email-received)
Vocabulaire français : Nouvel e-mail libellé — Déclenche un événement lorsqu’un e-mail reçoit un libellé. (https://pipedream.com/apps/gmail/triggers/new-labeled-email)
Vocabulaire français : Nouvel e-mail envoyé — Déclenche un événement pour chaque nouvel e-mail envoyé. (https://pipedream.com/apps/gmail/triggers/new-sent-email)
- action : Add Label to Email — Add label(s) to an email message. See the docs (https://pipedream.com/apps/gmail/actions/add-label-to-email)
- action : Archive Email — Archive an email message. See the documentation (https://pipedream.com/apps/gmail/actions/archive-email)
- action : Bulk Archive Emails — Archive multiple emails at once. See the documentation (https://pipedream.com/apps/gmail/actions/bulk-archive-emails)
- action : Create Draft — Create an unsent draft in the authenticated Gmail account. Same parameter shape as Send Email — the difference is the message is saved to Drafts instead of being sent. For a reply-draft, pass inReplyToMessageId (from Find Emails / Get Thread ); the subject, References , In-Reply-To , and threadId are derived from the referenced message. bodyType controls whether body is treated as plain text (default) or HTML. To draft to yourself, pass "me" in to — the action resolves it to the authenticated user's email address. No pre-call to Get Current User required. Attachments use file-ref inputs and require matching attachmentFilenames[] entries. See the documentation. (https://pipedream.com/apps/gmail/actions/create-draft)
- action : Create Filter — Create a Gmail filter that automatically acts on incoming mail matching the given criteria. Provide at least one criterion and at least one action. Criteria are combined with AND: a message must match every criterion you set. Actions apply only to mail that arrives after the filter is created; existing messages are not touched. Example — skip the inbox for cancelled-event notices that were not on the user's calendar: from = calendar-notification@google.com , query = "This event has been canceled" , negatedQuery = "removed from your calendar" , removeLabelIds = ["INBOX"] . Label IDs must be IDs, not names — use List Labels to resolve a label name to its ID (system labels like INBOX , STARRED , UNREAD , TRASH can be used directly). Use List Filters first to avoid creating duplicates. See the documentation. (https://pipedream.com/apps/gmail/actions/create-filter)
- action : Create Label — Create a new user label in the authenticated Gmail mailbox and return its ID. Call this before Modify Labels whenever the label the user wants to apply doesn't yet exist — List Labels will tell you what's already there. Idempotent: if a label with the same name already exists, the action swallows the 409, looks it up by name, and returns the existing label with alreadyExisted: true so the caller can proceed. Nested labels are expressed with / — e.g. Clients/Acme creates or targets a sub-label under Clients . color is optional; when provided, both textColor and backgroundColor must be supplied together and must come from Gmail's fixed palette. See the documentation. (https://pipedream.com/apps/gmail/actions/create-label)
- action : Delete Email — Moves the specified message to the trash. See the documentation (https://pipedream.com/apps/gmail/actions/delete-email)
- action : Delete Filter — Permanently delete a Gmail filter from the authenticated user's settings. Mail already processed by the filter is not changed; the filter simply stops applying to future incoming mail. The Gmail API deletes by filter ID — call List Filters first to find the id of the filter to remove. See the documentation. (https://pipedream.com/apps/gmail/actions/delete-filter)
- action : Delete Label — Immediately and permanently delete a user-created label from the authenticated Gmail mailbox, removing it from every message and thread it was applied to. Only user-created labels can be deleted — Gmail's built-in system labels ( INBOX , SENT , SPAM , TRASH , etc.) cannot. This deletes the label definition itself; to merely detach a label from specific messages without removing it, use Modify Labels with removeLabels instead. See the documentation. (https://pipedream.com/apps/gmail/actions/delete-label)
- action : Download Attachment — Download a Gmail message attachment to /tmp and return its path + metadata. File Stash syncs the file and exposes a presigned download URL so the caller can retrieve it. Call Find Emails (with format: "full" ) or Get Thread first — attachment IDs only appear in full-format message reads; each returned message's payload.parts[] enumerates attachments as { body.attachmentId, filename, mimeType } . Pass the enclosing message's id as messageId and the part's body.attachmentId as attachmentId . Gmail issues a new attachmentId for the same part on every read, so the download always uses the attachmentId you pass, and the filename and MIME type are resolved separately: by partId (stable across reads; recommended), then by a unique filename-and-size match, then by a unique size match. If none resolve, the file is saved as attachment-<id> with an extension detected from its contents. Set convertToPdf: true to convert image / HTML / plain-text / DOCX attachments to PDF during download; other MIME types are rejected. See the documentation. (https://pipedream.com/apps/gmail/actions/download-attachment)
- action : Find Emails — Search the user's Gmail mailbox with Gmail's native query syntax and return matching messages (headers + snippet by default; full bodies when requested). Use this tool for every "find", "search", "list my", or "show me" email intent. The q parameter accepts the full Gmail search operator set — combine operators freely: from:alan@ingen.com is:unread newer_than:7d has:attachment subject:"DNA sequences" . Common operators: from: , to: , subject: , has:attachment , filename:pdf , is:unread , is:starred , label:INBOX , newer_than:7d , older_than:1m , after:2025/01/01 , before:2025/12/31 , category:primary . labelIds accepts either raw label IDs ( INBOX , STARRED ) or user-visible names ( Clients/Acme ) — names are resolved server-side via List Labels . Each returned message carries id , threadId , labelIds , the decoded subject / sender / recipient / date , and a snippet . With format: "full" the decoded body text and payload.parts[].body.attachmentId + filename + mimeType are also included — feed those into Download Attachment , or feed threadId into Get Thread for the whole conversation. Set fields on every call to name just what you need — message records are large, and a wide search returns tens of thousands of characters that crowd out the rest of the task. id and threadId are always returned. To BROWSE or COUNT, use ["subject", "sender", "date"] . To READ or SUMMARISE — "catch me up", "what did X say about Y", "is there anything I need to reply to" — use ["subject", "sender", "date", "bodyText"] . bodyText is the decoded plain-text body (HTML converted, MIME scaffolding and attachments stripped), about half the size of the raw payload , and requesting it fetches full messages for you. Notification and marketing mail is mostly tracking links: pass includeLinks: false to read it, and keep the default only when you need a URL from the email. Never answer a question about what an email SAYS from snippet — it is a fixed ~200-character prefix, so the sentence you need is usually past its end, and nothing in a snippet indicates that it was cut. Where the snippet is all you asked for and content was likely cut, the message carries snippetTruncated: true . format stays metadata unless you need the raw MIME tree for Download Attachment , in which case pass format: "full" and request payload . Responses are capped. Over the cap: if you named fields , whole messages are dropped rather than your chosen fields being removed, and the note says how many of how many are shown — narrow q and retry. If you named none, messages are compacted instead so counts stay accurate. bodyText shrinks toward a floor before anything is dropped, flagging each cut message with bodyTruncated: true . See the documentation and Gmail search operators. (https://pipedream.com/apps/gmail/actions/find-email)
- action : Get Current User — Returns the authenticated Gmail user's name, email address, and mailbox stats (total messages and threads). Call this first when the user says 'my emails', 'my inbox', or needs identity context. Use the returned emailAddress to identify the user's own messages in Find Emails results. See the documentation. (https://pipedream.com/apps/gmail/actions/get-current-user)
- action : Get Send As Alias — Get a send as alias for the authenticated user. See the documentation (https://pipedream.com/apps/gmail/actions/get-send-as-alias)
- action : Get Thread — Fetch an entire Gmail thread (conversation) by thread ID — returns every message in order with headers, decoded body text, and attachment metadata. Use this after Find Emails when the user wants the full conversation rather than a single message. Each result from Find Emails includes a threadId you can pass here. With format: full (default) each message includes decoded text / html bodies and attachment metadata. Use format: metadata to skip bodies and get only headers + labelIds — useful for large threads. Responses are capped. An oversized thread is served as text : each message keeps subject , sender , recipient , date , and a decoded plain-text bodyText in place of payload (attachment metadata is omitted), shortened toward a floor if needed (cut messages carry bodyTruncated: true and bodyTotalChars ). Only if that still does not fit does it fall back to metadata , then drop messages from the tail. Every fallback sets truncated , servedFormat , and a note . Pass includeLinks: false to drop link URLs and images from the decoded text, which keeps notification and newsletter threads far smaller. See the documentation. (https://pipedream.com/apps/gmail/actions/list-thread-messages)
- action : List Filters — List every filter configured in the authenticated user's Gmail settings, including each filter's id , criteria (what it matches) and action (what it does to matching mail). Call this before Delete Filter to find the id of the filter to remove, or before Create Filter to check whether an equivalent filter already exists. Returns an empty filter list (or no filter key) when the user has no filters. See the documentation. (https://pipedream.com/apps/gmail/actions/list-filters)
- action : List Labels — List every label in the authenticated user's mailbox (system labels like INBOX , SENT , TRASH , STARRED , UNREAD and user-created labels). Call this before Modify Labels or Find Emails when you need to target a label that the user named rather than an obvious system label — it resolves a name like Clients/Acme to its opaque label ID. User labels are returned first, then system labels. See the documentation. (https://pipedream.com/apps/gmail/actions/list-labels)
- action : List Send as a Delegate Options — Retrieves available options for the Send as a Delegate field. (https://pipedream.com/apps/gmail/actions/list-delegate-options)
- action : List Send As Aliases — List all send as aliases for the authenticated user. See the documentation (https://pipedream.com/apps/gmail/actions/list-send-as-aliases)
- action : List Signature Options — Retrieves available options for the Signature field. (https://pipedream.com/apps/gmail/actions/list-signature-options)
- action : Modify Labels —  (https://pipedream.com/apps/gmail/actions/modify-labels)
- action : Remove Label from Email — Remove label(s) from an email message. See the docs (https://pipedream.com/apps/gmail/actions/remove-label-from-email)
- action : Send Email — Send a new email OR reply to an existing thread from the authenticated Gmail account. For a fresh message, set to / subject / body ; leave inReplyToMessageId blank. To reply to a thread, pass the id of any message in that thread as inReplyToMessageId — the tool preserves threading ( References , In-Reply-To , threadId ) and auto-prefixes Re: on the subject. Use Find Emails or Get Thread to locate the message ID. Set replyAll: true to fan-out to the original From / To / Cc (minus the user's own address); otherwise only the original sender is addressed. bodyType controls whether body is treated as plain text (default) or HTML. To send to yourself, pass "me" in to — the action resolves it to the authenticated user's email address. No pre-call to Get Current User required. Attachments: for small inline content (the common case in MCP / cloud runs), set attachmentContent to the file's text contents and attachmentFilename to its name. For files already on disk (Pipedream workflows, File Stash), use attachments[] + attachmentFilenames[] instead. See the documentation. (https://pipedream.com/apps/gmail/actions/send-email)
- action : Update Signature for Email in Organization — Update the signature for a specific email address in an organization. A Google Cloud service account with delegated domain-wide authority is required for this action. See the documentation (https://pipedream.com/apps/gmail/actions/update-org-signature)
- action : Update Signature for Primary Email Address — Update the signature for the primary email address. See the documentation (https://pipedream.com/apps/gmail/actions/update-primary-signature)
- trigger : New Attachment Received — Emit new event for each attachment in a message received. This source is capped at 100 max new messages per run. (https://pipedream.com/apps/gmail/triggers/new-attachment-received)
- trigger : New Email Matching Search — Emit new event when an email matching the search criteria is received. This source is capped at 100 max new messages per run. (https://pipedream.com/apps/gmail/triggers/new-email-matching-search)
- trigger : New Email Received — Emit new event when a new email is received. (https://pipedream.com/apps/gmail/triggers/new-email-received)
- trigger : New Labeled Email — Emit new event when a new email is labeled. (https://pipedream.com/apps/gmail/triggers/new-labeled-email)
- trigger : New Sent Email — Emit new event for each new email sent. (Maximum of 100 events emited per execution) (https://pipedream.com/apps/gmail/triggers/new-sent-email)