Amazon S3
Connect S3 buckets and prefixes — and S3-compatible storage — with access key credentials scoped to least privilege. Available on Business plans and above.
Last updated July 17, 2026
#What you need
S3 is available on Business plans and above. Create an S3 credential with:
- Access key ID and secret access key.
- Region and bucket name.
- Optional: a default prefix, a temporary session token, a custom endpoint URL and path-style addressing for S3-compatible storage.
The custom endpoint and path-style options let FileAgent connect to S3-compatible object storage, not just AWS.
#Least-privilege permissions
Use an IAM user or role scoped to the specific bucket and prefix, with only the actions a job needs:
s3:ListBucket (on the bucket)
s3:GetObject (read source)
s3:PutObject (write destination)
s3:DeleteObject (only for Move, Sync/Mirror, or Scheduled Purge)
Scope the policy to the prefix the job uses — a policy for reports/* won't allow exports/*.
#Set up and test
- Create the credential under Credentials → New credential → Amazon S3.
- Enter the access key, region, and bucket (plus any optional fields).
- Choose Test connection before saving.
#Common mistakes
- Policy too narrow or wrong prefix.
AccessDeniedusually means the action or prefix isn't covered. - Bucket policies / SCPs override IAM. An organization policy can deny even when the user allows.
- Wrong region. A mismatched region can surface as a connection error.
See S3 troubleshooting.