Gmail modules

Last update: Thu Jan 16 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
Workfront Fusion

In an Adobe Workfront Fusion scenario, you can automate workflows that use Gmail, as well as connect it to multiple third-party applications and services.

For instructions on creating a scenario, see the articles under Create scenarios: article index. For information about modules, see the articles under Modules: article index.

Access requirements

You must have the following access to use the functionality in this article:

Adobe Workfront plan*

Pro or higher

Adobe Workfront license*

Plan, Work

Adobe Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime Adobe Workfront Plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.

Prerequisites

To use Gmail modules, you must have a Gmail account.

Connect Gmail to Workfront Fusion

Connect Gmail to Workfront Fusion using Google Workspace
Connect Gmail to Workfront Fusion using gmail.com or googlemail.com

Connect Gmail to Workfront Fusion using Google Workspace

For instructions about connecting your Google Workspace account to Workfront Fusion, see Create a connection - Basic instructions.

Connect Gmail to Workfront Fusion using gmail.com or googlemail.com

If you are @gmail.com or @googlemail.com user you must create an OAuth client on the Google Cloud Platform in order to obtain a Client ID and Client Secret.

For step-by-step instructions on how to create the OAuth client and obtain a Client ID and Client Secret, see Connect Adobe Workfront Fusion to Google Services using a custom OAuth client.

Gmail modules and their fields

When you configure Gmail modules, Workfront Fusion displays the fields listed below. Along with these, additional Gmail fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.

Map toggle

Triggers
Actions
Iterators

Triggers

Watch emails

This trigger module executes a scenario when a new email is received to be processed.

The module returns all standard fields associated with the record or records, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

When you are configuring this module, the following fields display.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the email folder you want to watch.

Filter type

Select the filter type you want to use to watch emails

Simple filter

Fill out the Criteria, Sender Email Address, Subject, and Search Phrase fields
Gmail filter

In the Query field, enter the query that you want to use to filter emails.

For more information on Gmail filters, see Search operators in the Gmail documentation.

Criteria

Select whether you want to watch all email, only read emails, or only unread emails.

Sender email address

Enter an email address to watch only emails sent from that address.

Subject

Enter a text string to watch only emails that have that text string in the subject.

Search phrase

Enter a text string to watch only emails that have that text string anywhere in the email.

Mark email message(s) as read when fetched

Enable this option to mark retrieved emails as read.

Maximum number of results

Set the maximum number of results that Workfront Fusion will work with during one cycle.

Send an email

This action module sends a new email.

You specify the recipient of the email.

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

When you are configuring this module, the following fields display.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

From

Enter or map a sender email address.

Note: If you enter an incorrect email address, an error may occur when sending a message because your account may not have permission to send emails from an address different than your own.

To

Click Add, then enter or map the email address for each recipient.

Subject

Enter or map the email subject.

Content

Enter or map the email content (message body). HTML tags are allowed.

Attachments

Click Add to add an attachment. You can map a file from the previous modules.

Copy recipients

Click Add, then enter or map the email address for each copy recipient.

Blind copy recipients

Click Add, then enter or map the email address for each blind copy recipient.

Create a draft

This action module creates a new email draft and adds it to a folder you specify.

You specify the folder where you want to create a draft.

The module returns the ID of the email draft and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

When you are configuring this module, the following fields display.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the Gmail folder you want to create a draft in.

To

Click Add, then enter or map the email address for each recipient.

Subject

Enter or map the email subject.

Content

Enter or map the email content (message body). HTML tags are allowed.

Attachments

Click Add to add an attachment. You can map a file from the previous modules.

Copy recipients

Click Add, then enter or map the email address for each copy recipient.

Blind copy recipients

Click Add, then enter or map the email address for each blind copy recipient.

Mark an email as read

This action module marks an email as read.

You specify the ID of the email and its folder.

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the Gmail folder that contains the email.

Email ID (UID)

Enter or map the Email ID.

Mark an email as unread

This action module marks an email or an email draft as unread.

You specify the ID of the email and its folder.

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the Gmail folder that contains the email.

Email ID (UID)

Enter or map the Email ID of the email you want to mark as unread.

Move an email

This action module moves an email or an email draft to a folder you specify.

You specify the folder, the destination folder, and the ID of the email…

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the Gmail source folder that contains the email you want to move.

Destination folder

Select the Gmail target folder you want to move the email to.

Email ID (UID)

Enter or map the Email ID of the email you want to move.

Copy an email

This action module copies an email or email draft into a folder you specify.

You specify the folder, the destination folder, and the ID of the email…

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Folder

Select the Gmail source folder that contains the email you want to copy.

Destination folder

Select the Gmail target folder you want to copy the email to.

Email ID (UID)

Enter or map the Email ID of the email you want to copy.

Delete an email

This action module removes an email or an email draft from a folder you specify.

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

When you are configuring this module, the following fields display.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Gmail Message ID

Enter or map the Email ID of the email you want to delete.

Permanently

Enable this option to allow the module to permanently delete the email, instead of moving it to the trash folder.

Modify email labels

This action module modifies the label on an email message you specify.

The module returns the ID of the email and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.

When you are configuring this module, the following fields display.

Connection

For instructions on connecting your Gmail account to Workfront Fusion, see Connect Gmail to Workfront Fusion in this article.

Gmail Message ID

Enter or map the Email ID of the email you want to delete.

Labels to add

Select or map the label you want to add to the selected email message.

Labels to remove

Select or map the label you want to remove from the selected email message.

NOTE

Label to add and Label to remove fields load only user-created labels.

Iterators

Iterate attachments

You can iterate email attachments. Each attachment is a separate bundle in the module’s output. For more information, see Iterator module.

Source module

Select the module you want to iterate attachments from.

recommendation-more-help