Contact Free trial Login

Trigger a Flow When a New File is Created or Modified

The File, FTP, and SFTP connectors provide a listener (called On New or Updated file in Studio and Design Center) that polls a directory for files that have been created or updated. A message is generated for each file that is found.

The key part of this functionality is how to determine that a file is new. There are three strategies for making this determination:

  • Set the autoDelete parameter to true. This setting deletes each file after it has been processed so that all files found in the next poll are new.

  • Set moveToDirectory parameter to move each processed file to a different directory after it has been processed. This produces the same effect as autoDelete but without deleting the file.

  • Use the watermark parameter to only pick files that have been created or updated after the last poll was executed.

  • Use a matcher to filter the files.


Listeners function similarly for the FTP, SFTP, and File connectors. However, the XML element used for them is different.

Example: FTP Listener (On New File Trigger)
<flow name="onNewFile">
    <ftp:listener config-ref="file" directory="test-data/in" autoDelete="true">
        <fixed-frequency frequency="1000"/>

    <flow-ref name="processFile" />


The FTP connector provides a way of activating or deactivating the watermark. Here is an example:

Example: Watermarking with the FTP Listener
<ftp:listener doc:name="On New File"
    <scheduling-strategy >
      <fixed-frequency />