Create Folder
Description
The Create Folder activity creates a new folder at a specified location in IB Drive.
The parent folder determines where the new folder is created, and the folder name can be configured directly or provided dynamically using workflow data.
Common Capabilities
Process Data Support
This activity supports dynamic configuration using variables from the Process Data drawer.
You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.
Learn more → Using Process Data
Design-Time Configuration
Display Text
Specifies a user-defined name for the activity.
The display text appears on the workflow canvas and can be used to identify the purpose of the activity.
Parent Folder
Specifies the IB Drive folder in which the new folder will be created.
The folder can be specified using one of the following methods:
| Method | Description |
|---|---|
| Select Directory | Select the folder by browsing IB Drive using the folder picker. |
| By Id | Specify the unique IB Drive item ID of the folder. This is the default method. |
| By Path | Specify the logical path of the folder within IB Drive, for example /Agents/InvoiceProcessing/Input. |
The value can also be provided dynamically using workflow data.
This property is required.
Select the parent folder from IB Drive or provide a folder reference dynamically using workflow data.
Folder Name
Specifies the name of the new folder to be created.
This property is required.
The folder name must comply with the IB Drive naming rules.
IB Drive folder names:
- Can contain up to 255 characters.
- Cannot contain
\ / : * ? " < > |. - Cannot start or end with a space or period.
- Are case-insensitive within the same parent folder.
If a folder with the specified name already exists in the parent folder, the activity fails with an error.
The activity does not automatically rename the new folder or create a copy with a different name.
Wait All Incoming
Controls how this activity behaves when multiple incoming execution paths converge.
Determines whether the activity executes when:
- any incoming path completes, or
- all relevant incoming paths complete before execution
Learn more → Execution Control
On Error
Defines how the workflow behaves if this activity encounters a runtime error.
Supported strategies include Fault, Continue, Suspend, and Retry.
Outputs
Folder
Returns the metadata of the newly created folder.
The returned folder object contains the following properties:
| Property | Description |
|---|---|
| ItemId | The unique identifier (GUID) of the newly created folder. |
| Name | The name of the newly created folder. |
| Location | The logical path of the folder within IB Drive, for example /Agents/InvoiceProcessing/Input. |
| ParentId | The unique identifier (GUID) of the parent folder containing the newly created folder. |
| Size | The size associated with the folder. For folders, this is typically 0. |
| ContentType | The content type associated with the folder, if applicable. |
| Created | The UTC date and time when the folder was created in IB Drive. |
| Modified | The UTC date and time when the folder was last modified. |
The returned folder metadata can be used by downstream activities to perform additional operations on the newly created folder.
Remarks
- The specified parent folder must exist in IB Drive when the activity executes.
- The folder name must comply with the IB Drive naming rules.
- Folder names are case-insensitive within the same parent folder. For example,
Reportsandreportsare considered the same name. - If a folder with the specified name already exists in the parent folder, the activity fails with an error.
- The activity does not overwrite, merge with, or automatically rename an existing folder.
- IB Drive paths represent logical locations within the organization's IB Drive library and do not represent physical file system paths.