Upload File
Description
Uploads a file to Google Drive.
The file can be uploaded to a specific folder or directly to My Drive if no destination folder is specified.
Common settings
Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.
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.
File
The file to upload.
The activity accepts a File Reference, which represents a file managed by the IB-X platform.
File References can be obtained from:
- Get File
- Document generation activities
- Email attachment activities
- AI document processing activities
- Other activities that produce file outputs
Target Folder
The destination folder where the file will be uploaded.
You can:
- Select a folder using the Custom Picker Dialog.
- Provide a folder identifier dynamically through Process Data.
If no folder is specified, the file is uploaded directly to My Drive.
New File Name
Specifies a new name for the uploaded file.
If not specified, the original file name is retained.
Execution settings
Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.
If File Exists
Select the naming-conflict policy for the target folder:
| Option | Behavior |
|---|---|
| Overwrite | Replace the contents of the existing same-name file. Default. |
| Create Copy | Create a separate file with a unique name. |
| Throw Error | Report the conflict through On Error. |
The effective name is New File Name, when supplied; otherwise the source metadata name is used.
Output
Uploaded File
A File Reference representing the uploaded file. File References are a platform-wide IB-X file abstraction that can be passed to other activities that accept file inputs.
| Property | Description |
|---|---|
| Name | Name of the file. |
| Size | File size in bytes. May be empty when not available. |
| File ID | Unique identifier of the file in Google Drive. |
| MIME Type | MIME type of the file. |
| Parent Folder | Parent folder containing the file. |
| Created Time | When the file was created. |
| Modified Time | When the file was last modified. |
| Web View Link | Link to view the file in Google Drive. |
Remarks
- The authenticated Google account must have permission to upload files to the destination folder.
- If no destination folder is specified, the file is uploaded directly to My Drive.
- The uploaded file retains its original content regardless of whether a new file name is specified.
- The returned File Reference represents the file stored in Google Drive and can be used by subsequent IB-X activities.
Example: Upload a generated report
Bind Write To CSV → File Reference to File, select the target folder, and set New File Name to SalesExport.csv if a different name is required. Choose If File Exists explicitly. Pass Uploaded File to the next file-consuming activity.