Skip to main content
Version: Current

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 Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Agent Data, Workflow 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.

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.


Wait All Incoming​

Execution Control

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​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling


Output​

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.

PropertyDescription
NameName of the file.
SizeFile size in bytes. May be empty when not available.
File IDUnique identifier of the file in Google Drive.
MIME TypeMIME type of the file.
Parent FolderParent folder containing the file.
Created TimeWhen the file was created.
Modified TimeWhen the file was last modified.
Web View LinkLink 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.