# Create Upload Session

> `UiPath.Box.Activities.File.ChunkedUpload.CreateUploadSession`

`UiPath.Box.Activities.File.ChunkedUpload.CreateUploadSession`

The **Create Upload Session** activity uses the Box [Create upload session](https://developer.box.com/reference/post-files-upload-sessions/) API to upload a new file (**File Path**) to a specified folder (**Parent Folder ID**).

After creating the session, the activity outputs a `BoxUploadSession` object (**UploadSession**) that includes the session properties.

## How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-setup) steps.
2. Add the [Box Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-scope) activity to your project.
3. Add the **Create Upload Session** activity inside the **Box Scope** activity.
4. Enter values for the [Input](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-create-upload-session#create-upload-session) property.
5. Create and enter a `BoxUploadSession` variable for the [Output](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-create-upload-session#create-upload-session) property.
   * Your input property values are sent in the [Create upload session](https://developer.box.com/reference/post-files-upload-sessions/) API operation request.
   * The operation returns the `BoxUploadSession` value to your output property variable.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-185414-3cc48fbd-d5de562f.webp)

## Properties

### Common

* **ContinueOnError** - Specifies if you want the activity to continue running when an error is thrown. This field supports only `Boolean` values.
* **DisplayName** - The display name of the activity. This field supports only `Strings` or `String` variables.

### Input

* **File Path** - The location of the file that you want to upload. This field supports only `Strings` or `String` variables.
* **Parent Folder ID** - The ID of the parent folder where you want to upload the file.
  + Enter a value of *"0"* to use the root folder of the application.
  + To get the ID of a folder that is not the root, use the [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content) activity.

### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Options

* **File Name** - The name that you want to apply to the file. This field supports only `Strings` or `String` variables. If this property is left empty, the existing file name is applied.

### Output

* **Upload Session** - The `BoxUploadSession` object that includes the session properties. Enter a `BoxUploadSession` variable. The `BoxUploadSession` object includes multiple [properties](https://developer.box.com/reference/resources/upload-session/) that you can use in other activities.