OneDrive Connector 25.3
OneDrive Connector Help

# Insert Information into OneDrive

The connector's `insert` fetch action inserts information into OneDrive.

To use the `insert` action, you must construct some XML that specifies where to add each item, and the information to insert. You must add the XML to the action as the value of the `insertXML` action parameter. The exact structure of the XML depends on the type of item that you want to insert.

The XML contained in the `insertXml` parameter 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 OneDrive Connector Reference.

## Insert a Folder

To insert a folder in OneDrive, your XML must include the following properties:

`ONEDRIVE_PARENT_ID` | The ID of the parent folder in which you want to insert the new folder. You can find the ID for existing folders in documents retrieved by the synchronize fetch action.
`ONEDRIVE_USER_ACCOUNT_ID` | The OneDrive user account ID.
`ONEDRIVE_NAME` | The name of the new folder.
`ONEDRIVE_TYPE` | The type of item to insert into OneDrive. Set this property to `folder`.
`ONEDRIVE_DESCRIPTION` | The folder description.

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

    <insertXML>
      <insert>
        <reference>My Reference</reference>
        <property name="ONEDRIVE_PARENT_ID" value="folder.9d6007287fc386c5.9D6007287FC386C5"/>
        <property name="ONEDRIVE_USER_ACCOUNT_ID" value="9d6007287fc386c5"/>
        <property name="ONEDRIVE_NAME" value="newfolder"/>
        <property name="ONEDRIVE_TYPE" value="folder"/>
        <metadata name="ONEDRIVE_DESCRIPTION" value="my new folder"/>
      </insert>
    </insertXML>

## Insert a File

To insert a file into OneDrive, your XML must include the following properties:

`ONEDRIVE_PARENT_ID` | The ID of the parent folder in which you want to insert the file. You can find the ID for existing folders in documents retrieved by the synchronize fetch action.
`ONEDRIVE_USER_ACCOUNT_ID` | The OneDrive user account ID.
`ONEDRIVE_NAME` | The name of the new file that is created in OneDrive.

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

    <insertXML>
      <insert>
        <reference>My Reference</reference>
        <property name="ONEDRIVE_PARENT_ID" value="folder.9d6007287fc386c5.9D6007287FC386C5"/>
        <property name="ONEDRIVE_USER_ACCOUNT_ID" value="9d6007287fc386c5"/>
        <property name="ONEDRIVE_NAME" value="newfile.txt"/>
        <file>
          <type>file</type>
          <displayname>newfile.txt</displayname>
          <content>C:\Path\To\My\NewFile.txt</content>
        </file>
      </insert>
    </insertXML>

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

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 OneDrive Connector 25.3

Topic Title: Insert Information into OneDrive