S3 Bucket Uploader avatar
S3 Bucket Uploader
Try for free

No credit card required

View all Actors
S3 Bucket Uploader

S3 Bucket Uploader

Try for free

No credit card required

Upload the items from the default dataset of an actor's run to an S3 bucket in JSON format.

Amazon S3 Bucket upload

This actor allows you to upload the default dataset of an actor's run to an AWS S3 bucket. It provides easy-to-use tools for injecting information into file names/path names. Additionally, it provides the option of either uploading the entire dataset to one file, or each dataset item as its own file.

The Amazon S3 Bucket upload actor is best used within the webhooks of another actor, as to allow for the automatic uploading of its default dataset's items.


Divided into two short sections, this actor's input is intuitive.

Bucket configuration

This section contains details for configuring your bucket. Ensure that you've filled in everything exactly right, especially your credentials.

To learn more about how to get your credentials, check out this page.

Data configuration

In this section, you provide the run ID of the actor, as well as the path for the item and the file name. There are some restrictions for the fileName and pathName inputs as to prevent unnecessary errors:

  • pathName cannot start with or end with a / symbol.
  • Neither field can include a period (.) character. (the file extension will be automatically added for you)
  • fileName can't include any / characters.

Within pathName and fileName, you have access to 6 variables:

VariableExampleDescriptionUnique for each item
actorNamemy-actorThe name of the actor matching the provided run ID.No
runIdBC6hdJvyNQStvYLL8The run ID of the actor which was providedNo
date2022-05-29The date at which the actor finished its run.No
now1653851198127The current time in milliseconds.Yes
uuidb2638dac-00b5-4e29-b698-fe70b6ee6e0bA totally unique ID.Yes
incrementor3An integer that increments up for every item.Yes

Variables allow you to easily generate unique file names when writing multiple files (preventing files from being overwritten). now and uuid are great options when you need unique values. Here is an example of some variables being used in the actor's input:

2  "pathName": "{actorName}/datasets/{date}",
3  "fileName": "{uuid}-item{incrementor}",
4  "separateItems": true

Notice that you must wrap a variable name in {curlyBraces} for it to work.

Here is what the final path for one file might look like with this configuration:


By default, the actor will write the entire dataset as one file in the S3 bucket. In order to write each dataset item as a separate file in the S3 bucket, set separateItems to true. When you have this option set to true, ensure that you are using at least one unique variable in the fileName, otherwise it will keep writing and overwriting the same file (unless you use unique variables in the pathName, however, that is not recommended).

Maintained by Community
Actor metrics
  • 6 monthly users
  • 99.7% runs succeeded
  • days response time
  • Created in May 2022
  • Modified 8 months ago