Gmail

action_gmail · action · Email · Available · v1.0.0

Description

Dedicated Gmail node via the official Google API (OAuth). Unlike the generic IMAP Email node it uses the tenant Google connection (Settings → Integrations) with automatic, transparent access-token refresh — no re-login on each run. Three operations: send (to/cc/bcc recipients, subject, text and/or HTML body, optional attachments), list (search messages with Gmail query syntax, e.g. "from:[email protected] is:unread newer_than:7d"), get (read one message by id: headers, text + HTML body, attachment list). Credentials live in the tenant encrypted vault, never inside the workflow; all calls go through the runtime anti-SSRF/exfiltration guard. Use case: automatic customer notifications straight from the workflow, sending reports or PDF invoices generated upstream, inbox triage (read unread, classify with an AI node, reply or route), extracting orders from incoming email, scheduled sales follow-ups.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`operation` Operazione	`enum` `sendlistget`	yes	`send`	send = invia · list = cerca messaggi · get = leggi un messaggio.
`integrationLabel` Account Google (opzionale)	`string`	no	—	Se hai connesso più account Google, indica la label dell'integrazione da usare. Vuoto = quella predefinita.
`to` A (To)	`string`	no	— [email protected], [email protected]	Uno o più destinatari separati da virgola. Obbligatorio per send.
`cc` Cc	`string`	no	—	—
`bcc` Ccn (Bcc)	`string`	no	—	—
`replyTo` Rispondi a (Reply-To)	`string`	no	—	—
`subject` Oggetto	`string`	no	—	—
`bodyText` Corpo (testo)	`string (multiline)`	no	—	Versione testo semplice. Puoi usare solo testo, solo HTML, o entrambi (multipart/alternative).
`bodyHtml` Corpo (HTML)	`rich-text`	no	—	Versione HTML formattata. Se compili sia testo sia HTML, i client mostrano l'HTML.
`attachmentsJson` Allegati (JSON)	`JSON object/array`	no	— [{ "filename": "report.pdf", "content": "<base64>", "mimeType": "application/pdf" }]	Array di allegati { filename, content (base64), mimeType }. Tipicamente collegato all'output di un nodo precedente (es. PDF: Genera → base64). Accetta anche il formato { name, base64, contentType }.
`query` Ricerca Gmail (q)	`string`	no	— is:unread from:[email protected] newer_than:7d	Sintassi di ricerca Gmail. Vuoto = messaggi più recenti.
`maxResults` Numero massimo	`number`	no	`10`	Quanti messaggi restituire (1–25). Per ognuno vengono recuperati mittente/oggetto/data/anteprima.
`messageId` ID messaggio	`string`	no	—	L'id del messaggio (dal risultato di list o da un trigger). Obbligatorio per get.

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-action_gmail-1",
  "defId": "action_gmail",
  "label": "Gmail",
  "config": {
    "operation": "send",
    "maxResults": 10
  }
}

🔗 Related nodes in the same category

Ready to use Gmail?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes