۶Ƶ

DocumentationWorkfrontWorkfront Guide

Microsoft Office 365 Email modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

In an ۶Ƶ Workfront Fusion scenario, you can automate workflows that use Microsoft Office 365 Email, as well as connect it to multiple third-party applications and services.

In order to use Office 365 Email with ۶Ƶ Workfront Fusion, it is necessary to have an Office 365 account. You can create one at www.office.com.

For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions

After you grant consent, you are redirected back to the Workfront Fusion administration page where you can continue creating your scenario.

Access requirements

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

۶Ƶ Workfront plan*
Pro or higher
۶Ƶ Workfront license*
Plan, Work
۶Ƶ 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 ۶Ƶ Workfront plan, your organization must purchase ۶Ƶ Workfront Fusion as well as ۶Ƶ 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 ۶Ƶ Workfront Fusion as well as ۶Ƶ 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 ۶Ƶ Workfront Fusion licenses, see ۶Ƶ Workfront Fusion licenses.

Prerequisites

To use Microsoft Office 365 Email modules, you must have a Microsoft Office 365 Email account.

Microsoft Office 365 Email API information

The Microsoft Office 365 Email connector uses the following:

Base URL
https://graph.microsoft.com/v1.0
API version
v1.0
API tag
v2.6.5

Connecting the Office 365 Email service to Workfront Fusion

For instructions about connecting your Office 365 Email account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions

NOTE
Some Microsoft apps use the same connection, which is tied to individual user permissions. Therefore, when creating a connection, the permissions consent screen displays any permissions that were previously granted to this user’s connection, in addition to any new permissions needed for the current application.
For example, if a user has “Read table” permissions granted via the Excel connector and then creates a connection in the Outlook connector to read emails, the permissions consent screen will show both the already granted “Read table” permission and the newly required “Write email” permission.

Microsoft Office 365 Email modules and their fields

When you configure Microsoft Office 365 Email modules, Workfront Fusion displays the fields listed below. Along with these, additional Microsoft Office 365 Email 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 in ۶Ƶ Workfront Fusion.

Message

Create and Send a Message (legacy)

Creates and sends an email message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
Subject
Enter or map the subject line of the message.
Body Content Type
Select whether the body content of the message is HTML or Text.
Body content
Enter or map the message body text of the email.
Importance

Select the importance of the email

  • Low
  • Normal
  • High
To Recipients

Add the email address to which you want to send the messages:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

CC Recipients

Add the recipients that you want to receive a copy of the message:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Bcc Recipients

Add the recipients that you want to copy on the message, without allowing other recipients to see their names or email addresses:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Attachments

Add the attachments to the email:

  • File name

    Enter the file name. Example: sample.doc

  • Data

    Enter the file data to the field or map the source of the file.

Internet Message Headers

Add the message headers for the email.

  • Name

    Enter the name of the header

  • Email Address

    Enter a value for the header.

Create and Send a Message

Creates and sends an email message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
Subject
Enter or map the subject line of the message.
Body Content Type
Select whether the body content of the message is HTML or Text.
Body content
Enter or map the message body text of the email.
Importance

Select the importance of the email

  • Low
  • Normal
  • High
To Recipients

Add the email address to which you want to send the messages:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

CC Recipients

Add the recipients that you want to receive a copy of the message:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Bcc Recipients

Add the recipients that you want to copy on the message, without allowing other recipients to see their names or email addresses:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Attachments

Add the attachments to the email:

  • File name

    Enter the file name. Example: sample.doc

  • Data

    Enter the file data to the field or map the source of the file.

Internet Message Headers

Add the message headers for the email.

  • Name

    Enter the name of the header

  • Email Address

    Enter a value for the header.

From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Limit
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Delete a Message

Deletes an existing email message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Message ID
Select or map the ID of the message you want to delete.

Get a message

Gets the metadata of a specific message

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Message ID
Select or map the ID of the message you want to retrieve metadata for.
Get MIME contents
Enable this option to retrieve data about the MIME content of the message. MIME content may include images, audio, video, or other types of files.

Move a Message

Moves an email message to a selected folder in the mailbox.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
Message ID
Select or map the ID of the message you want to move to a different folder.
Mail Folder
Select or map the ID of the folder where you want to move the message.

Search messages

Searches for messages based on specific criteria.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Mail Folder
Select the folder that contains the messages you want to search.
Search
Enter your search query. For information on how to write a search query, see the Microsoft support article .
Order by

Select how you want to order the results:

  • Subject (Ascending or descending)
  • Created Date Time (Ascending or descending)
  • Last Modified Date Time (Ascending or descending)
  • Received Date Time (Ascending or descending)
Limit
Enter the maximum number of messages Workfront Fusion should return during one scenario execution cycle.

Watch Messages

Triggers when a new email message is sent or received.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
Watch Messages

Select the messages you want to watch:

  • Only Unread
  • Only read
  • All
Mail Folder
Select the folder that contains the messages you want to watch.
Search
Enter your search query. For information on how to write a search query, see the Microsoft support article .
Limit
Enter the maximum number of messages Workfront Fusion should return during one scenario execution cycle.

Draft Message

Create a Draft Message

Creates a new email message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
Subject
Enter the subject line of the message.
Body Content Type
Select whether the body content of the message is HTML or Text.
Body content
Enter the message body text of the email.
Importance

Select the importance of the email

  • Low
  • Normal
  • High
To Recipients

Add the recipients to which you want to send the messages:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

CC Recipients

Add the recipients The you want to receive a copy of the message:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Bcc Recipients

Add the recipients that you want to copy on the message, without allowing other recipients to see their names or email addresses:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Attachments

Add the attachments to the email:

  • File name

    Enter the file name. Example: sample.doc

  • Data

    Enter the file data to the field or map the source of the file.

From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Send a Draft Message

Sends an email message that is currently in draft.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Draft Message ID
Select or map the Message ID of the draft you want to send.

Update a Message

Updates an existing message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Enter a message ID

Select how you want to identify the message to update:

  • Enter Manually

    Enter or map the message ID.

  • Select from the list

    Select the folder that contains the message you want to update, then select the message

Subject
Enter the subject line of the message.
Body content
Enter the message body text of the email.
Importance

Select the importance of the email

  • Low
  • Normal
  • High
To Recipients

Add the email address to which you want to send the messages:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

CC Recipients

Add the recipients The you want to receive a copy of the message:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Bcc Recipients

Add the recipients that you want to copy on the message, without allowing other recipients to see their names or email addresses:

  • Name

    Enter the name of the contact

  • Email Address

    Enter the email address of the contact.

Attachments

Add the attachments to the email:

  • File name

    Enter the file name. Example: sample.doc

  • Data

    Enter the file data to the field or map the source of the file.

Mark it as Read
Enable this option to mark the updated message as read.

Attachment

Download an Attachment

This module downloads the specified attachment.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Message ID
Select or map the ID of the message that contains the attachment you want to download.
Attachment ID
Enter or map the ID of the attachment you want to download.

List Attachments

This module retrieves a list of attachments belonging to the specified message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Message ID
Select or map the ID of the message you want to retrieve attachments from.
Limit
Enter or map the maximum number of attachments you want the module to return during each scenario execution cycle.

Other

Add an Attachment

This module adds a large attachment to a message.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
From email address

To use a shared email address, enter the address here. The user whose credentials are used in the connection used for this module must have access to the shared folder.

Leave this field blank to use connection owner's own email address.

Message ID
Select or map the ID of the message you want to add an attachment to.
Source file
Select a file from a previous module, or map the source file's name and data.

Make an API Call

This module allows you to perform a custom API call.

Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in ۶Ƶ Workfront Fusion.

Connection
For instructions about connecting your Office 365 account to Workfront Fusion, see Create a connection to ۶Ƶ Workfront Fusion - Basic instructions.
URL
Enter a path relative to https://graph.microsoft.com. Example: /v1.0/me/messages
Method
Headers
Add the headers of the request in the form of a standard JSON object.For example, {"Content-type":"application/json"}. Workfront Fusion adds the authorization headers for you.
Query String
Add the query for the API call in the form of a standard JSON object.
Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43