Skip to main content

Forward Mail

UiPath.MicrosoftOffice365.Activities.Mail.ForwardMail

Description​

Uses the Microsoft Graph Create forward and Forward event message API to forward a message (Message), with additional content (Body), to one or more recipients (To).

Scopes​

This activity requires the following scopes:

  • Mail.ReadWrite AND Mail.Send

OR

  • Mail.ReadWrite AND Mail.Send.Shared

OR

  • Mail.ReadWrite.Shared AND Mail.Send

OR

  • Mail.ReadWrite.Shared AND Mail.Send.Shared

Project compatibility​

Windows - Legacy | Windows

Configuration​

Properties

Attachments​

  • Attachments - A collection containing the paths to the files to be attached to the email.
  • Attachments Collection - An additional list of files to be attached to the email.
  • Replace Existing - Indicates whether to replace the existing attachments with the same name. This field supports Boolean values.

Common​

  • DisplayName - The display name of the activity. This property supports String variables and string formatted values.

Input​

  • Account - (Optional) The email address with which to interact. This may include any shared mailbox to which the current user has access rights. If left blank, the current user's account is assumed. This property supports String variables and string formatted values.

    note

    Account field is mandatory for ApplicationIdAndSecret and ApplicationIdAndCertificate authentication types.

  • Body - The email's message body. This property supports String variables and string formatted values.

  • Message - The email to forward. This field supports only Office365Message variables. Enter the Result output property variable from the Get Mail activity and specify the item in the array that you want to use (e.g., foundMessages(0)).

  • New Subject - The new subject of the email. If left blank, the original subject is used. This property supports String variables and string formatted values.

Misc​

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level. This field supports Boolean values.

Options​

  • Is Draft - If selected, the message is saved as a draft and not sent. This field supports Boolean values.

Recipients​

  • BCC - A list of additional email addresses that you want to add as Bcc recipients. This field supports only String[] variables.

  • CC - A list of additional email addresses that you want to add as Cc recipients. This field supports only String[] variables.

  • To - A comma-separated list of email addresses that you want to send your mail forward to. This field supports only String[] variables.

    note

    To enter one email address, include it between { } and declare it with " " (e.g., {"user@uipath.com"}). To enter multiple email addresses, include all between { }, declare each with " ", and separate each by a comma (e.g., {"user@uipath.com","test@uipath.com"}).

How it works​

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

  1. Complete the steps.
  2. Add the Microsoft Office 365 Scope activity to your project.
  3. Add an activity or run an external process that outputs a Office365Message object (e.g., Get Mail).
  4. Add the Forward Mail activity inside the Microsoft Office 365 Scope activity.
  5. Enter values for the Input properties.
  6. Run the activity.

docs image