Platform Events
All Event Types

File Received

Overview

The File Received Event is published when a file is uploaded using the File Request module in a CloudFiles Dataroom. This module allows users to configure file requests and specify a destination folder for uploaded files.

The File Request module can be created and added to a Dataroom either manually from your CloudFiles account in the CloudFiles Web App or through flow automations using the Create File Request action. Once configured, the Dataroom can be shared via a CloudFiles-generated sharing link, enabling external users to upload files directly into the specified destination.

How To Use This Event ?

To use CloudFiles Platform Events, you must first setup your platform event triggered flow as shown in the CloudFiles Event Handler Flow Template. This article will introduce you to the concepts of the event type in the CloudFiles Event Object as well as event details that are returned by the Get Event Details flow action.

Once you are familiar with these, you will understand how to interpret & use these as illustrated in the sections below.

Document image


Event Type For Decision Filter

Please use file-received as the type filter when selecting this event in the decision element in flow builder.

Output Fields From Get Event Details

The corresponding Get Event Details flow action returns the File Received sub-type with useful information including file request details, received file's details and uploader details and much more. Refer to the image below for a list of outputs and descriptions of the parameters returned in this sub-type.

Document image

  1. uploadedAt - The date and time when the file was uploaded via the File Request module
  2. destinationDriveId - The Drive ID of the destination external storage folder where the uploaded file is stored
  3. destinationLibrary - The library of the destination folder (e.g., sharepoint, google )
  4. destinationResourceId - The Folder ID of the destination folder specified during the File Request configuration
  5. fileRequestId - The unique CloudFiles identifier for the File Request module
  6. fileRequestName - The name given to the File Request module during configuration
  7. Id - The unique Resource ID of the received file in the destination folder.
  8. linkId - The unique ID of the link from where the file was uploaded.
  9. linkUrl - The the url/link from where the file was uploaded.
  10. name - The name of the uploaded file
  11. uploaderEmail - The email address of the uploader (only captured if email authentication is mandatory in the Dataroom security settings)