Gmail Send Email

Gmail Send Email

Send emails using your connected Gmail account via Gmail API

Node Type

Action

Category

Gmail

Icon

Gmail

Overview

The Gmail Send Email node is an action node that sends emails using your connected Gmail account. This powerful integration enables you to programmatically send emails through Gmail API, perfect for automated notifications, workflow-based communications, and business process automation.

Key Features

  • HTML Email Support: Send rich HTML formatted emails with full styling support
  • Multiple Recipients: Support for To, CC, and BCC fields with comma-separated email lists
  • Gmail Integration: Seamless integration with Gmail and Google Workspace
  • OAuth Security: Secure authentication through Google OAuth
  • Template Support: Use dynamic content and variables in email fields
  • Error Handling: Comprehensive error handling and validation

Prerequisites

Google Account Connection

Must have a connected Google account with appropriate permissions

Google account connected via OAuth
Gmail Compose scope permissions
Access to Gmail API

Email Requirements

Understanding of email composition and delivery requirements

Valid recipient email addresses (comma-separated for multiple)
Clear subject line and email body content
Understanding of HTML email formatting (optional)
Knowledge of CC and BCC fields usage

Technical Requirements

Technical setup and configuration requirements

Google OAuth service properly configured
Internet connectivity for Gmail API communication
Proper exception handling for API failures and authentication issues

Node Configuration

Required Fields

To

Type:text
Required:Yes
Value Type:string

Recipient email address. Use comma-separated values for multiple recipients (e.g., '[email protected], [email protected]').

Subject

Type:text
Required:Yes
Value Type:string

The subject line of the email.

Body (HTML allowed)

Type:textarea
Required:Yes
Value Type:string

The body content of the email. HTML formatting is supported for rich email content.

Optional Fields

Cc

Type:text
Required:No
Value Type:string

Optional CC recipients. Use comma-separated values for multiple recipients.

Bcc

Type:text
Required:No
Value Type:string

Optional BCC recipients. Use comma-separated values for multiple recipients.

Examples & Use Cases

Automated Notifications

Send automated email notifications for workflow events

Workflow Structure

🔔 Webhook Trigger → 📊 Process Data → 📧 Gmail Send Email → ✅ Confirm

Trigger on external events, process data, and send notification emails to stakeholders automatically.

Rich HTML Email Campaigns

Send beautifully formatted HTML emails with dynamic content

Workflow Structure

📊 Data Source → 🤖 AI Content Generation → 📧 Gmail Send Email → 📈 Analytics

Generate personalized HTML email content with AI, then send to multiple recipients with rich formatting.

Business Process Automation

Automate business communications and approvals

Workflow Structure

📝 Form Submission → 🔍 Data Validation → 📧 Approval Email → 📋 Update Records

Process form submissions, validate data, send approval emails to managers, and update business records.

HTML Email Example

Rich HTML Email Template

Example of HTML content for the email body field

<!DOCTYPE html>
<html>
<head>
  <style>
    .email-container { max-width: 600px; margin: 0 auto; font-family: Arial, sans-serif; }
    .header { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 20px; text-align: center; }
    .content { padding: 20px; background: #f8f9fa; }
    .button { display: inline-block; background: #007bff; color: white; padding: 12px 24px; text-decoration: none; border-radius: 5px; margin: 10px 0; }
  </style>
</head>
<body>
  <div class="email-container">
    <div class="header">
      <h1>Welcome to Flowdrop!</h1>
    </div>
    <div class="content">
      <h2>Your workflow has been completed successfully</h2>
      <p>Hello {{user_name}},</p>
      <p>Your automated workflow has processed {{item_count}} items and completed successfully.</p>
      <a href="{{dashboard_url}}" class="button">View Results</a>
      <p>Best regards,<br>The Flowdrop Team</p>
    </div>
  </div>
</body>
</html>

Best Practices

Do's

  • Use clear, descriptive subject lines for better email deliverability
  • Test HTML email templates in different email clients
  • Validate email addresses before sending to avoid bounces
  • Use CC and BCC appropriately for different recipient types
  • Include unsubscribe links for marketing emails
  • Keep email content concise and actionable

Don'ts

  • Don't send emails without proper authentication setup
  • Avoid using excessive HTML formatting that may not render properly
  • Don't send to invalid or non-existent email addresses
  • Avoid sending too many emails too quickly (rate limiting)
  • Don't include sensitive information in email content
  • Avoid using all caps in subject lines (spam filters)
💡
Pro Tip: For best results, test your HTML email templates across different email clients (Gmail, Outlook, Apple Mail) to ensure consistent rendering. Use inline CSS styles for better compatibility.

Troubleshooting

Common Issues

Authentication Errors

Symptoms: Node fails with 'Google access token not found' error

Solution: Ensure your Google account is properly connected with Gmail Compose scope permissions. Reconnect your Google account if needed and verify OAuth permissions.

Invalid Email Addresses

Symptoms: Node fails with 'Invalid email address' error

Solution: Check that all email addresses in To, CC, and BCC fields are valid. Use comma-separated format for multiple recipients and ensure no extra spaces or invalid characters.

Missing Required Fields

Symptoms: Node fails with 'Missing required email fields' error

Solution: Ensure all required fields (To, Subject, Body) are provided and not empty. Check that template variables are properly resolved.

Rate Limiting

Symptoms: Node fails with rate limiting errors

Solution: Gmail API has rate limits. Implement delays between email sends or batch emails to avoid hitting rate limits.

HTML Rendering Issues

Symptoms: Email content doesn't display as expected

Solution: Use inline CSS styles instead of external stylesheets. Test HTML content in different email clients. Avoid complex CSS that may not be supported.

Related Resources