---
title: Infoveave Gmail Setup Guide
description: Learn how to connect and configure Gmail as a connection in Infoveave.
---

import { Aside, Steps } from '@astrojs/starlight/components';
import { MediaPlayerComponent } from "../../../../../components/video-player";
import RunScript from "../../../../../components/RunScript.astro";

# Gmail

<MediaPlayerComponent
  video="Fetching-attachments.mp4"
    chapters={
       [
  {
    "start": 0,
    "end": 1,
    "text": "Click on Connections under Administration",
    "description": "From the Infoveave menu, click on 'Administration' and then click on 'Connections' to manage your data connections."
  },
  {
    "start": 1,
    "end": 4,
    "text": "Create a New Gmail Connection",
    "description": "Click on the 'New Connection' button to add a new connection. Scroll down to the 'Email' section and select the 'Gmail' connection type."
  },
  {
    "start": 4,
    "end": 23,
    "text": "Configure and Authenticate Gmail Connection",
    "description": "In the 'New Gmail Connection' dialog, enter a descriptive name. Click 'Connect to Gmail,' then proceed to sign in to your Google account by entering your email, completing any CAPTCHA, and entering your password. Grant infoveave.cloud access to view your email messages and settings, then click 'Continue'. 'Validate' and 'Save' to complete the connection setup."
  },
  {
    "start": 23,
    "end": 26,
    "text": "Click on Workflows under Automation",
    "description": "From the Infoveave menu, click on 'Automation' and select 'Workflows' to access the workflow management section."
  },
  {
    "start": 26,
    "end": 29,
    "text": "Create a New Workflow",
    "description": "Click the 'New Workflow' button. Enter the workflow name and add a description. Once done, save the workflow."
  },
  {
    "start": 29,
    "end": 33,
    "text": "Add Gmail Activity to Workflow",
    "description": "Use the search bar on the right-hand panel to find 'Gmail' under 'Email activities' and drag the Gmail activity icon onto the workflow canvas."
  },
  {
    "start": 33,
    "end": 53,
    "text": "Configure Gmail Activity",
    "description": "Select the newly added Gmail activity on the canvas. In the configuration panel, select the 'Gmail Account Setup' connection you previously created. Set the 'Folder name' to 'Infoveavefiles'. Adjust the 'From received date' and the 'To received date'. Finally, enable 'Download attachment' and click 'Validate'."
  },
  {
    "start": 53,
    "end": 59,
    "text": "Add Start Iteration Activity",
    "description": "Search for 'Start iteration' under 'Flow control activities' and drag it onto the canvas, connecting it after the Gmail activity. In its properties, change the 'Operation' to 'Iterate over each file' and set the 'Identifier Column' to 'File name'."
  },
  {
    "start": 59,
    "end": 64,
    "text": "Add Upload to Datasource Activity",
    "description": "Search for 'Upload to Datasource' under 'Infoveave activities' and drag it onto the canvas, connecting it after the 'Start iteration' activity. In its properties, select the 'Datasource' and enter 'Table'."
  },
  {
    "start": 64,
    "end": 67,
    "text": "Add End Iteration Activity",
    "description": "Search for 'End iteration' under 'Flow control activities' and drag it onto the canvas, connecting it after the 'Upload to Datasource' activity."
  },
  {
    "start": 67,
    "end": 88,
    "text": "Validate All Workflow Activities",
    "description": "Click the 'Validate' button for each of the 'Start Iteration', 'Upload to Datasource', and 'End Iteration' activities to ensure all configurations are correct and there are no errors in the workflow setup."
  },
  {
    "start": 88,
    "end": 93,
    "text": "Run the Workflow",
    "description": "Click the 'Run' button located at the top right of the workflow editor. Confirm that you want to run the workflow by clicking 'Yes' in the pop-up prompt."
  },
  {
    "start": 93,
    "end": 117,
    "text": "Monitor Workflow Execution",
    "description": "Observe the 'Workflow logs' to track the real-time execution status of each step. You can click on individual activities in the left panel to view their respective data outputs and ensure successful processing."
  }
]
    }
  poster="/images/introduction-poster.png"
  posterText="Fetching Gmail Attachments and Uploading to Datasource"
  client:load
/>

Gmail connection helps you connect to your **Gmail account** for accessing and fetching your email messages directly from Infoveave.

## Adding a Gmail Connection

To create a new Gmail connection:

<Steps>
1. Go to the **Email** section under **Administration** > **Connections**.
2. Select **Gmail** from the available connectors.
3. In the **New Gmail Connection** form, provide a unique **Name** for your connection.
4. Click **Connect to Gmail** and log in with your Gmail account credentials.
</Steps>

## Connection Parameters

When setting up a Gmail connection, you need to provide the following details:

| Field    | Description |
|----------|-------------|
| **Name** | A unique name to identify your Gmail connection. |
| **Connect to Gmail** | Authenticate with your Gmail account using the Google sign-in flow. |

## Steps to Validate and Save

<Steps>
1. After connecting your Gmail account, click **Validate** to verify the connection.
2. If validation succeeds, click **Save** to store the connection.
3. You can now use Gmail as a datasource in your Infoveave workspace.
</Steps>

## Example Use Case

With a Gmail connection configured, you can:

- Create offline backups of Gmail accounts for disaster recovery.
- Identify communication patterns (who emails whom, frequency).
- Extract attachments in bulk for review.
- Detect duplicate or spam messages.
- Email analytics: volume trends, busiest days/times, response times.
- Sentiment analysis on incoming/outgoing messages (customer feedback, complaints).