Get Folders
Description
Retrieves folders from a Google Drive folder and returns their Folder References and the number of folders returned.
The activity can optionally search subfolders recursively.
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
A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.
Connection Name
The configured Google Drive connection used to access Google Drive resources.
Parent Folder
The folder whose subfolders will be retrieved.
You can:
- Select a folder using the Custom Picker Dialog.
- Provide a folder identifier dynamically through Process Data.
Default value: My Drive
Recursive
Determines whether folders are retrieved only from the specified folder or from all nested subfolders.
| Value | Behavior |
|---|---|
| False | Retrieves folders only from the specified folder. |
| True | Retrieves folders from the specified folder and all subfolders recursively. |
Default value: False
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
- Retry
Output
Folders
A collection of Folder References. Bind the collection through Process Data and pass individual references to activities that accept folder inputs.
Each folder includes metadata such as:
- Folder ID
- Folder Name
- MIME Type
- Parent Folder
- Created Time
- Modified Time
- Web View Link
Folder Count
Number of the folder references returned by the activity.
Folder Reference
Each Folder Reference represents a returned folder. Folder References are a platform-wide IB-X folder abstraction that can be passed to other activities that accept folder inputs.
| Property | Description |
|---|---|
| Name | Name of the folder. |
| Size | May be empty for folders. |
| Folder ID | Unique identifier of the folder in Google Drive. |
| Parent Folder | Parent folder containing this folder. |
| Created Time | When the folder was created. |
| Modified Time | When the folder was last modified. |
| Web View Link | Link to view the folder in Google Drive. |
Remarks
- The authenticated Google account must have access to the specified folder.
- Only folders accessible to the authenticated account are returned.
- When Recursive is enabled, all nested folders are searched recursively.
- Large folder structures may increase execution time when recursive search is enabled.