Microsoft Outlook connector methods

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 11 minutes de lecture

    • The Microsoft Outlook connector methods automate various actions on the Microsoft Outlook. In an automation flow, the methods are connected with other methods and components. To use the methods, you must first expose them.

    The Microsoft Outlook connector enables the automation of routine tasks within the Microsoft Outlook application, integrating these functions into broader automated workflows.

    You can automate processes such as sending or replying to emails without manual intervention. This connector provides various methods to facilitate the automation of actions within Microsoft Outlook. These methods can be seamlessly combined with other methods or components within an automation framework, enabling more complex and efficient workflow designs.

    AddFolder

    Adds a new folder within a specified hierarchy and, optionally, a sub folder to the Outlook account set.

    Tableau 1. AddFolder method parameters
    Parameter Description Data port type Data type
    MainFolder Name of the folder that the method adds to the Outlook account.

    This parameter specifies the main folder where the new folder is added.

    		 Data in String
    SubFolderName Name of the sub folder that the method adds under the main folder.

    This parameter specifies the name of the new folder to be created.

    If you use this parameter, you must use the IsSubFolder parameter.

    		 Data in String
    IsSubFolder Option to indicate that the folder created in the SubFolderName parameter is a subfolder under the main folder.

    This parameter indicates whether the SubFolderName must be added as a subfolder within the main folder. Defaults to False, meaning SubFolderName is added directly under the main folder.

    		 Data in Boolean

    Close

    Closes the Microsoft Outlook explorer by specifying the profile name.

    This method can be used as a cleanup activity after all automation tasks are completed.

    Tableau 2. Close method parameters
    Parameter Description Data port type Data type
    ProfileName This parameter specifies the Outlook profile name that you want to close. Data in String

    DeleteFolder

    Deletes the specified folder and all subfolders under it.

    Tableau 3. DeleteFolder method parameters
    Parameter Description Data port type Data type
    FolderName Name of the folder that the method deletes. Data in String

    DeleteMail

    Deletes one or more emails. Deletes an email based on its unique entry ID.
    Conseil :
    Use the GetMails method to provide the emails the DeleteMail method will delete.
    Tableau 4. DeleteMail method parameters
    Parameter Description Data port type Data type
    MailId Takes the email from which the method deletes the emails.

    This parameter specifies the unique entry ID of the email that needs to be deleted.

    		 Data in String

    ForwardMail

    Forwards an email based on its unique entry ID to a specified email address (EmailID).

    Tableau 5. ForwardMail method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email that needs to be forwarded. Data in String
    EmailID This parameter specifies the email address to which the email must be forwarded. Data in String
    CC This parameter specifies Email address to send a carbon copy (CC) of the forwarded email. Data in String
    BCC This parameter specifies Email address to send a blind carbon copy (BCC) of the forwarded email. Data in String
    Subject This parameter specifies the subject line of the forwarded email. Data in String
    Return This method returns a boolean value indicating whether the email was successfully forwarded.

    A return value of true signifies that the operation was successful.

    		 Data out Boolean

    GetAttachmentNames

    Retrieves a list of attachment names associated with an email specified by its unique entry ID.

    Tableau 6. GetAttachmentNames method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email for which attachment names are to be retrieved. Data in String

    GetExistingAccounts

    Retrieves information about configured accounts such as a list of configured accounts and their count.

    This is helpful when there are multiple accounts configured in the outlook.

    Tableau 7. GetExistingAccounts method parameters
    Parameter Description Data port type Data type
    Accounts This parameter is passed by reference and is expected to be a List (Of String). Upon calling this method, it is populated with the list of configured account names. Data out List1
    Count This parameter is passed by reference. Upon calling this method, this parameter is populated with the count of configured accounts. Data out Int32

    GetFolderNames

    Retrieves and returns a list of folder names from the active outlook account.

    Tableau 8. GetFolderNames method parameters
    Parameter Description Data port type Data type
    Return Returns the list of folder names from the active outlook account. Data out List1

    GetMail

    Retrieves all details of an email, specified by its unique entry ID (MailId).

    To specify additional criteria for retrieving all details of an email, on the GetMail method bar, click the method settings icon (Method settings icon.), select the required mail items such as CC, BCC, Subject, Body, Sender, To, AttachmentsCount, ReceivedTime, EntryId.

    Tableau 9. GetMail method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email to retrieve details from. Data in String

    GetMails

    Retrieves a list of mail entry IDs from a specified folder within an email system.

    The GetMails method retrieves a list of mail entry IDs from a specified folder within an email system.

    Tableau 10. GetMails method parameters
    Parameter Description Data port type Data type
    FolderName This parameter specifies the name of the folder from which to retrieve mail entry IDs.

    Default value is "Inbox".

    		 Data in String
    Filter This parameter specifies a filter condition to apply when retrieving mail entry IDs. Data in String
    NoOfMails This parameter specifies the maximum number of mail entry IDs to retrieve. Default value is 10. Data in Int32
    UnreadOnly This parameter indicates whether to retrieve only unread mails (True) or all mails (False). Default is True. Data in Boolean
    AvoidMeetingItems This parameter specifies whether to exclude meeting items from the retrieved mail entry IDs. Default is True. Data in Boolean
    FetchingOrder This parameter specifies the order in which mails are fetched. For example, FIFO, LIFO. Default is FIFO. Data in FetchingOrder
    Return This parameter returns a list of emails from the specified folder. Data out List1
    Count This parameter specifies total count of mail entry IDs retrieved. Data out Int32

    GetSenderName

    Retrieves the sender's email address associated with an email specified by its unique entry ID.

    Tableau 11. GetSenderName method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email for which the sender's email address is to be retrieved. Data in String
    Return This method returns a string value indicating sender name. Data out String

    MarkAsRead

    Marks an email as read based on its unique entry ID.

    Tableau 12. MarkAsRead method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email for which the sender's email address is to be retrieved. Data in String
    Return This method returns a boolean value indicating whether the email was successfully marked as read.

    A return value of true signifies that the operation was successful.

    		 Data out Boolean

    MarkAsUnread

    Marks an email as unread based on its unique entry ID.

    Tableau 13. MarkAsUnread method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email that needs to be marked as unread. Data in String
    Return This method returns a boolean value indicating whether the email was successfully marked as unread.

    A return value of true signifies that the operation was successful.

    		 Data out Boolean

    MoveMail

    Moves an email based on its unique entry ID from one folder to another folder within the email system.

    Tableau 14. MoveMail method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email that must be moved. Data in String
    DestinationFolder This parameter specifies the name or path of the destination folder where the email must be moved. Data in String

    ReadMsgFile

    Reads the contents of a .msg file from the file system.

    Tableau 15. ReadMsgFile method parameters
    Parameter Description Data port type Data type
    Filepath This parameter specifies the path to the .msg file that must be read. Data in String
    Body This parameter is passed by reference (ByRef) and is populated with the body content of the .msg file after the method call. Data out String

    Reply

    Generates and sends a reply to an email specified by its unique entry ID.

    Tableau 16. Reply method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email to which the reply is sent. Data in String
    CC This parameter specifies Email address to send a carbon copy (CC) of the reply. Data in String
    BCC This parameter specifies email address to send a blind carbon copy (BCC) of the reply. Data in String
    Subject This parameter specifies the subject line of the reply email. Data in String
    Body This parameter specifies the body content of the reply email. Data in String
    Attachments This parameter specifies file paths of the attachments to include in the reply email.

    Multiple files can be separated by the pipe symbol or the vertical bar (|) to split the attachment file paths.

    When you upgrade automations to plugins above 13.0, update earlier automations that use "," or ";" with "|", when multiple file paths are passed. Use the pipe symbol or the vertical bar (|) to split the attachment file paths.

    		 Data in String
    IsHtmlBody This parameter indicates whether the body content of the reply email is in HTML format.

    Default is False.

    		 Data in Boolean
    Return This method returns a boolean value indicating whether the reply was successfully sent.

    A return value of true signifies that the operation was successful.

    		 Data out Boolean

    SaveAllAttachments

    Saves all attachments from an email specified by its unique entry ID into a specified folder path.

    Tableau 17. SaveAllAttachments method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email from which attachments must be saved. Data in String
    FolderPath This parameter specifies the path of the folder where attachments must be saved. Data in String

    SaveAttachment

    Saves specified attachment of a mail with given entry ID into a given file.

    Tableau 18. SaveAttachment method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email from which attachment must be saved. Data in String
    AttachmentName This parameter specifies the name of the attachment that must be saved. Data in String
    Filepath This parameter specifies the path of the file where attachment must be saved. Data in String

    SaveMail

    Saves an email specified by its unique entry ID (MailId) to a file at a specified file path.

    Tableau 19. SaveMail method parameters
    Parameter Description Data port type Data type
    MailId This parameter specifies the unique entry ID of the email to be saved. Data in String
    Filepath This parameter specifies the path where the email must be saved as a file Data in String
    SaveType This parameter specifies the format in which the email must be saved.

    Default is MsgSaveType.olMSG, indicating Microsoft Outlook MSG format.

    		 Data in MsgSaveType

    SendMail

    Sends an email to recipient. It offers various optional parameters to customize the email, including the ability to add images, set the sender's address, and specify CC and BCC recipients.

    Tableau 20. SendMail method parameters
    Parameter Description Data port type Data type
    ToEmailId This parameter specifies email address of the recipient. Data in String
    Image This parameter specifies an optional image to include in the email. Data in Drawing.Bitmap
    From This parameter specifies the email address of the sender. If not specified, the default sender's address is used. Data in String
    CC This parameter specifies Email address to send a carbon copy (CC) to. Data in String
    BCC This parameter specifies email address to send a blind carbon copy (BCC) to. Data in String
    Subject This parameter specifies the subject line of the email. Data in String
    Body This parameter specifies the body content of the email. Data in String
    Attachments This parameter specifies file paths of the attachments to include in the email.

    Multiple files can be separated by the pipe symbol (|) to split the attachment file paths.

    When you upgrade automations to plugins above 13.0, update earlier automations that use "," or ";" with "|", when multiple file paths are passed. Use the pipe symbol or the vertical bar (|) to split the attachment file paths.

    		 Data in String
    IsHtmlBody This parameter indicates whether the body of the email is in HTML format. Default is False. Data in Boolean
    Return This method returns a boolean value indicating whether the email was successfully sent.

    A return value of true signifies that the operation was successful.

    		 Data out Boolean

    SentAs

    Sends an email on behalf of another email account.

    Tableau 21. SentAs method parameters
    Parameter Description Data port type Data type
    ToEmailId This parameter specifies email address of the recipient. Data in String
    SentOnBehalfEmailID This parameter specifies email address on whose behalf the email will be sent. Data in String
    Subject This parameter specifies the subject line of the email. Data in String
    Body This parameter specifies the body content of the email. Data in String
    Attachments This parameter specifies file paths of the attachments to include in the email.

    Multiple files can be separated by the pipe symbol (|) to split the attachment file paths.

    When you upgrade automations to plugins above 13.0, update earlier automations that use "," or ";" with "|", when multiple file paths are passed. Use the pipe symbol or the vertical bar (|) to split the attachment file paths.

    		 Data in String
    IsHtmlBody This parameter indicates whether the body of the email is in HTML format. Default is False. Data in Boolean

    SetAccount

    Specifies the outlook account on which you want to perform operations for your automation tasks.

    The SetAccount method must be used initially, before any other method of this connector, to specify or set the context or email account for subsequent methods to execute upon.

    Tableau 22. SetAccount method parameters
    Parameter Description Data port type Data type
    AccountName This parameter specifies the Outlook email account ID on which you want to perform operations. Data in String