Get Object
Downloads an object from an Amazon S3 bucket into a File variable.
Get Object downloads an object from an Amazon S3 bucket and puts it in a File variable, so the next steps can read it, attach it to an email or upload it somewhere else.
Before you start
The AWS S3 actions don't use a stored credential. Each action has the same four connection fields:
| Field | Type | Required | What to put |
|---|---|---|---|
| Access Key | Text | Yes | The access key ID of an AWS IAM user, for example AKIAโฆ. |
| Secret Key | Text | Yes | The secret access key that belongs to that access key. |
| Region | Text | Yes | The AWS region of the bucket, as its code, for example eu-central-1. |
| Bucket | Text | Yes | The bucket name, for example my-company-invoices. |
The IAM user needs S3 permissions on the bucket for the operation you run. The values you type are visible to everyone who can edit the process, so prefer an IAM user limited to the buckets the process needs.
Add the action
In the Process Designer toolbox, open AWS S3 and pick Get Object (or type Get Object in the search box).
Inputs and outputs
| Field | Direction | Type | Required | What to put / what you get |
|---|---|---|---|---|
| Access Key, Secret Key, Region, Bucket | Input | Text | Yes | The connection fields described above. |
| Object Key | Input | Text | Yes | The full key of the object, including every prefix, for example invoices/2026/inv-001.pdf. |
| Output File | Output | File | Yes | The downloaded object. |
Example
Object Key invoices/2026/inv-001.pdf โ Output File is a file named inv-001.pdf.
Good to know
- The file is named after the last part of the key:
invoices/2026/inv-001.pdfgivesinv-001.pdf. - If the object doesn't exist, the step fails with "Object not found! Ensure the bucket and object key are correct."
- If a connection field is empty, the step fails with "Invalid connection details."
- Common errors from S3: "Access forbidden! Ensure the connection details are valid." (wrong keys or missing permission), "Unable to connect! Ensure the provided region matches the bucket one." (wrong Region), and "Unrecognized Amazon Region: โฆ" (a region code that doesn't exist).