Skip to main content
The Gmail integration allows you to send emails directly through your Gmail account using Google’s Gmail API. This provides a more reliable and feature-rich email sending experience compared to generic SMTP.

​
Authentication

The Gmail integration requires OAuth2 authentication to access your Gmail account. You can connect with Typebot default OAuth app or use your own credentials.

​
Configuration Options

​
Basic Settings

  • To: The recipient’s email address
  • Subject: The email subject line
  • Body: The email content (supports plain text and HTML)
  • Attachments: Include file attachments (variable containing file URLs)

​
Advanced Settings

  • Label: Apply a Gmail label to the sent email
  • From: Specify a custom sender name and email (e.g., “John Doe <[email protected]>”). By default, the sender name and email is the one of the account used to connect to Gmail.
  • Reply To: Set a different email address for replies
  • Thread ID: Send email as a reply to an existing conversation thread

​
Attachments

You can attach files to your Gmail emails by providing a variable that contains file URLs. The attachments can be:
  • A single file URL (string)
  • Multiple file URLs (array of strings)
Gmail has a 25MB total attachment size limit. Make sure your combined attachments don’t exceed this limit.

​
Response Mapping

The Gmail block can save response data to variables:
  • Thread ID: The conversation thread ID (useful for tracking email conversations)
⌘I