# Amazon S3 trigger - New file

Triggers when a new file is added in a selected bucket/folder in Amazon S3.

Checks selected folder for new file once every poll interval. The output includes the file’s metadata and file contents. The file contents is returned as a streaming object and can handle unlimited file size.

Note that in Amazon S3, when a file is renamed, it is considered a new file. When a file is uploaded and overwrites an existing file with the same name, it is considered an updated file but not a new file.

Amazon S3 - New file trigger Amazon S3 - New file trigger

# Input fields

Field name Description
Region The region of the bucket to monitor for new/updated file, for example, us-west-2. In Amazon S3, go to Bucket > Properties > Static website hosting to find your region in the Endpoint URL.
Bucket The bucket to monitor for new CSV file. Select a bucket from the picklist or enter the bucket name directly.
Folder path The folder to monitor for new CSV files. Define full path (for example, folder 1/subfolder 1). Sub-folders will not be monitored. Root folder or restricted folder is used by default.
Chunk size
(in kilobytes)
Default is 1024 KB, minimum is 32 KB. Workato manages the chunk size automatically by default. Configure this when you want to optimize the data throughput yourself. Larger chunk size will increase throughput, but may exceed API limit.

This trigger supports Trigger Condition, which allows you to filter trigger events.

# Output fields

Field name Description
Object name The name of the file. Note that this is not file path.
Last modified The last modified date/time of the file.
E tag The hash of the file object, generated by Amazon S3.
Size The file size in bytes.
Storage class Storage class (opens new window) of this file object. Usually S3 Standard.
File contents Contents of the file.


Last updated: 7/2/2021, 7:31:20 AM