activities
latest
false
UiPath logo, featuring letters U and I in white

Productivity activities

Last updated Mar 13, 2026

Forward Email

UiPath.MicrosoftOffice365.Activities.Mail.ForwardEmailConnections

Description

Forwards a specified email to new recipients.

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 | Cross-platform

Configuration

  • Microsoft Outlook 365 connection - The connection for the Microsoft 365 account to use in the activity.
  • Use shared mailbox - Set the toggle to On if you want to use a shared mailbox. Default value is Off.
    • Forward as - The email address of a user or a shared mailbox to forward from.
  • Email - The email to forward. This field accepts Office365Message variables. Use the See more button menu to use a variable as the input mode.
  • To - The primary recipients of the email, separated by pressing the Enter or Tab key. This property supports String[] variables and string array formatted values.
  • Body - The body of the email. Use the editor to enter and edit text. This property supports String variables and string formatted values.
  • Save as draft - Boolean value. Set to True to save the email as a draft instead of being forwarded.

Additional options

Input

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

  • Attachment(s) - The attachments to be added to the email message. Use the plus menu to switch to other input modes: Build a Collection of Attachments or Use variable. This field supports IResource input.

  • Preferred timezone - Set the timezone for replied email messages. If this is not specified, the default timezone is UTC.

  • Request delivery receipt - Set this option to True to specify whether to receive a delivery receipt. By default, this option is set to False.

  • Request read receipt - Set this option to True to specify whether to receive a read receipt. By default, this option is set to False.

    Note:

    When you enable the Request delivery receipt or Request read receipt, or both, they instruct the email service provider to request confirmation from the email client of the recipient when:

    • The message is delivered to the mailbox of the recipient (delivery receipt).
    • The recipient opens the message (read receipt).

Recipients

  • CC - The secondary recipients of the email, separated by pressing the Enter or Tab key. This property supports String[] variables and string array formatted values.
  • BCC - The hidden recipients of the email, separated by pressing the Enter or Tab key. This property supports String[] variables and string array formatted values.
Note:

For more details on the plus menu options, check Designing automations.

Example

docs image

For more details, also check the following resources:

  • Description
  • Scopes
  • Project compatibility
  • Configuration
  • Additional options
  • Example

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated