51ºÚÁϲ»´òìÈ

DocumentationWorkfront51ºÚÁϲ»´òìÈ Workfront Fusion

Gmail modules

Last update: Fri Apr 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In an 51ºÚÁϲ»´òìÈ 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

Expand to view access requirements for the functionality in this article.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
51ºÚÁϲ»´òìÈ Workfront package Any
51ºÚÁϲ»´òìÈ Workfront license

New: Standard

Or

Current: Work or higher
51ºÚÁϲ»´òìÈ Workfront Fusion license**

Current: No Workfront Fusion license requirement

Or

Legacy: Workfront Fusion for Work Automation and Integration
Product

New:

  • Select or Prime Workfront package: Your organization must purchase 51ºÚÁϲ»´òìÈ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase 51ºÚÁϲ»´òìÈ Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on 51ºÚÁϲ»´òìÈ Workfront Fusion licenses, see 51ºÚÁϲ»´òìÈ Workfront Fusion licenses.

Prerequisites

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

Connect Gmail to Workfront Fusion connect-gmail-to-workfront-fusion

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 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 51ºÚÁϲ»´òìÈ 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

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 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.

Actions

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.

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.

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.

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.

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.

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.

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.

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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3