Exchange Web Service Connector 26.1
Exchange Web Service Connector Help

# Insert Messages into the Exchange Repository

You can use the `insert` fetch action to insert e-mail message (`.eml`) files into the Exchange repository. The insert action does not support attachments.

To insert a message into the repository, you must specify the following properties using the `insertXML` parameter of the `insert` fetch action.

`Mailbox` | The mailbox in which to insert the message, for example, `someone@example.com`.
`FolderPath` | (Optional) The path of the folder in which to insert the message, for example `Inbox/MyFolder`. The default value is `“”`.
`RootFolderId` | (Optional). The ID of the folder that `FolderPath` is relative to. This property accepts the same values as the `BaseMailboxFolder` configuration parameter. The default value of this property is the folder specified by the `BaseMailboxFolder` configuration parameter. For more information about the `BaseMailboxFolder` parameter, refer to the Exchange Web Service Connector Reference.

For example, the value of your `insertXML` action parameter might look like this:

    <insertXML>
     <insert>
      <reference>reference</reference>
      <property name="Mailbox" value="someone@example.com"/>
      <property name="FolderPath" value="Inbox/MyFolder"/>
      <property name="RootFolderId" value="MsgFolderRoot"/>
      <metadata name="fieldname" value="fieldvalue"/>
      <!-- ... -->
      <file>
       <type>file</type>
       <content>C:\My Folder\Message_to_insert.eml</content>
      </file>
     </insert>
    </insertXML>

The XML must be URL-encoded before being used in the action command. For example:

    http://host:port/action=Fetch&FetchAction=Insert
                                 &ConfigSection=MyTask
                                 &InsertXML=[URL-encoded XML]

For more information about using the `insert` fetch action, refer to the Exchange Web Service Connector Reference.

Copyright 2025 Open Text
Version 26.1 | Last updated January 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Exchange Web Service Connector 26.1

Topic Title: Insert Messages into the Exchange Repository