Skip to content

Update Email Node

The Update Email node allows you to programmatically modify an email in a Microsoft mailbox. Supported actions include marking an email as read and moving it to a different folder.

Node Summary

  • Node Name: Update Email
  • TaskType: UpdateEmail
  • Category: Microsoft 365 / Outlook
  • Node Type: Task
  • Purpose: Updates properties of an existing email in the user's Microsoft account (mark as read, move to another folder).

Required Service Connections

  • ThirdParty-Microsoft: A valid Microsoft 365 service connection must be configured and available.

Required Inputs

Field LabelTypeRequiredDescription
Email IDTextYesThe unique identifier of the email to update. Usually retrieved from a previous "Get Emails" node.

Optional Inputs

Field LabelTypeDescription
Set to ReadBooleanIf true, marks the email as read. Default is false if not provided.
Move to FolderTextThe display name or folder path to move the email to (e.g. "Archive", "Processed", "CustomFolder/SubFolder").

Output

This node does not return specific data but updates the state of an email in the mailbox. If successful:

  • taskSuccess = true
  • statusReturn = "Completed"
  • taskMessage = "Email Sent"

If unsuccessful:

  • taskSuccess = false
  • statusReturn = "Fail"
  • taskMessage will contain the error details.

Example Usage

This node is typically used after retrieving emails via the Get Emails or Get Emails by Mailbox node. You can pass the Email ID from that node to this one to update its status or move it.

Notes

  • The input field "Email ID" must match the format returned by Microsoft Graph API or the earlier email retrieval task.
  • Folders must already exist; this node does not create folders.
  • The email update is performed via the Microsoft Graph API, using the configured access token.

Troubleshooting

  • Ensure the Email ID is correct and refers to a message within the same mailbox linked to the ThirdParty-Microsoft service account.
  • Ensure proper permissions are granted to the Microsoft service connection to allow mail modification (e.g. Mail.ReadWrite).
  • If you see Error While Sending Email, the error will usually contain clues about permission or folder issues.

Tentech 2024