Move email action in Gmail package

Use the Move email action to move a single email within a Gmail mailbox by removing it from one or more source labels and adding it to one or more destination labels. This action supports both system-defined and user-defined Gmail labels and can be used inside a loop to move emails individually.

Considerations

An error is displayed if any of the following conditions are encountered when you deploy your automation to move an email:
  • The specified Gmail session does not exist.
  • Any label specified in Source labels to remove or Destination labels to add is invalid.

Settings

  • Select the Gmail session using one of the following options:
    • Session name: To select an existing Gmail session by name.
    • Variable: Select a variable of type Session with sub-type Gmail
  • In the Source labels to remove field, enter the label(s) to be removed from the email.

    You can also click the Insert a value icon to select an existing variable.

    Note: Labels can be system-defined (for example, INBOX, TRASH) or user-defined (for example, WORK, PERSONAL).
  • In the Destination labels to add field, enter the label or labels to be added to the email.

    You can also click the Insert a value icon to select an existing variable.

  • The Keep other labels check box is selected by default.
    This option is used to specify whether the labels that are not listed in Source labels to remove must be retained.
    Note: By default, all other labels already applied to the email are retained. However, if you clear the check box, all existing labels except the destination labels are removed.