IMAP Connector 26.1
IMAP Connector Help

# Insert Messages into a Mailbox

You can use the connector's `insert` fetch action to insert messages into a mailbox on an IMAP server.

NOTE: The connector can only insert messages in `.eml` format.

To use the `insert` action, you must construct some XML that specifies where to insert the message, and the information to insert. In the XML you must set the `MAILBOX` property to the address of the destination mailbox. For example:

    <insertXML>
      <insert>
        <property name="MAILBOX" value="user@domain.com"/>
        <file>
          <type>file</type>
          <content>D:\files\email.eml</content>
        </file>
      </insert>
    </insertXML>

You must add the XML to the insert action as the value of the `insertXML` action parameter. 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]

When the action is successful, the connector returns a UID for each inserted message.

For more information about using the `insert` fetch action, refer to the IMAP 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 IMAP Connector 26.1

Topic Title: Insert Messages into a Mailbox