# Insert Documents

The `insert` fetch action inserts information into the Documentum repository. To use the insert action, you must construct some XML that specifies where to add each item, 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 `insertXML` must include:

- The `file` element, to specify a file. For information about the ways in which you can specify a file, see the documentation for the `insert` fetch action in the Documentum Connector Reference.
- The `FOLDER` property, to specify the folder to add the file to.

You can optionally include:

- The `FORMAT` property, to specify the format of the file using format names recognized by the Documentum server. You can find the format names by querying the `dm_format` object in Documentum. The `FORMAT` property is optional. If you do not set this property, the default value of `unknown` is used.
- Metadata to assign to existing Documentum fields.

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

    <InsertXML>
       <insert>
          <property name="FOLDER" value="documents/pdfs"/>
          <property name="FORMAT" value="pdf"/>
          <metadata name="keywords" value="things"/>
          <!-- ... -->
          <file>
             <type>file</type>
             <content>things.pdf</content>
          </file>
       </insert>
    </InsertXML>

_FT_HTML5_bannerTitle.htm