Box Connector 25.3
Box Connector Help

# Insert Files into Box

The connector's `insert` fetch action inserts files into the Box repository. To use the insert action, you must construct some XML that specifies where to add each file, and the information to insert. URL encode the XML and add it to the action as the value of the `insertXML` action parameter. For example:

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

The following table describes the properties that you must set in the `insertXML` provided to the insert action:

Property | Description | Required
--- | --- | ---
`ENTERPRISE_USER_LOGIN` | The login name of the user account to add the file to. If you are inserting files into Box Enterprise, you can set this property or the `UID` property. You can only use this property with Box Enterprise. | No
`PATH` | The desired destination path of the file in the Box repository, relative to the top-level accessible folder. | Yes
`UID` | The user ID of the Box user. | Yes, unless you are inserting files into Box Enterprise and have set `ENTERPRISE_USER_LOGIN` instead.

For example:

    <insertXML>
       <insert>
         <property name="PATH" value="/folder/file.txt"/>
         <property name="UID" value="..."/>
         <file>
           <type>content</type>
           <content>SGVsbG8gV29ybGQNCg==</content>
         </file>
       </insert>
    </insertXML>

The `<file>` element contains the file to insert into the repository. You can supply the path to a file, base-64 encoded content, or choose to send the file to the connector's data port. For more information about the `insert` fetch action and the XML elements you can use in the `insertXML` parameter, refer to the Box Connector Reference.

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

Topic Title: Insert Files into Box