# 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 poll interval can be 10 mins or 5 mins, depending on your plan. Check the Pricing and Plans page to find out more. 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.
# Input fields
|When first started, this recipe should pick up events from||When recipe starts for the first time, it will pick up files created from this specified time. Once recipe has been run or tested, value cannot be changed. Learn more about this field here.|
|Bucket region||The region of the bucket to monitor for new file, e.g. 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 file. Select a bucket from the picklist or enter the bucket name directly.|
|Folder||The folder to monitor for new file. Select a folder from the picklist or enter the folder path directly.|
|Include sub-folders||Select Yes to monitor sub-folders for new files as well.|
|Chunk size |
|File contents will be streamed in chunks of this size. 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
|File 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 of this file object. Usually |
|File contents||Contents of the file. This is a streaming object and can handle unlimited file size.|