> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/integrations-and-plugins/integrations/amazon-s3.md).

# Amazon S3

Connect Amazon Simple Storage Service to Kizen to work with live S3 data in real time. Build Agentic Workflows to upload Kizen files to S3 buckets, copy files, retrieve file lists, and more.

{% hint style="success" %}
**Audience:** Admins, Developers, Solution Architects

**Purpose:** Explains what the Amazon S3 integration is, when to use it, and how it works within your <code class="expression">space.vars.automations</code>
{% endhint %}

## Overview

Connect Amazon Simple Storage Service (S3) to <code class="expression">space.vars.Kizen\_company\_name</code> with the Amazon S3 integration. Upload <code class="expression">space.vars.Kizen\_company\_name</code> files to S3 buckets, copy files and file content between <code class="expression">space.vars.Kizen\_company\_name</code> and S3, retrieve lists of files, and create temporary presigned upload and download URLs, all from your <code class="expression">space.vars.automations</code> in <code class="expression">space.vars.Kizen\_company\_name</code>.

### What Is the Amazon S3 Integration?

The Amazon S3 integration adds six action steps to the <code class="expression">space.vars.automation</code> builder:

* **Upload File:** Uploads a <code class="expression">space.vars.Kizen\_company\_name</code> file to Amazon S3
* **Get File Content:** Creates an identical file in <code class="expression">space.vars.Kizen\_company\_name</code> from an S3 file
* **Get File Metadata:** Returns information about an S3 file
* **List Files:** Returns a list of S3 files by folder
* **Copy File:** Creates a server-side copy of an S3 file
* **Generate Presigned URL:** Creates an upload or download URL for S3 storage or retrieval

You configure the connection to Amazon S3 once, as an integration secret in <code class="expression">space.vars.Kizen\_company\_name</code>. See [Set Up Amazon S3](/docs/integrations-and-plugins/integrations/amazon-s3/set-up-amazon-s3-in-kizen.md) in <code class="expression">space.vars.Kizen\_company\_name</code> for details.

The integration supports a single S3 environment or multiple environments, each with its own connection credentials. You specify which to use when you call an S3 action from your <code class="expression">space.vars.automation</code>. To learn more, see [Work with Amazon S3 Files in an Agentic Workflow](/docs/integrations-and-plugins/integrations/amazon-s3/work-with-amazon-s3-files-in-an-agentic-workflow.md).

### When to Use the Amazon S3 Integration

Use the Amazon S3 integration when you want to build <code class="expression">space.vars.automations</code> to access your S3 files and storage.

If your team's documents, exports, media, or compliance records reside in their own S3 buckets and you want to be able to write to these buckets automatically, without the need for custom integration code and without giving individual users direct access to your Amazon Web Services account, this integration can help.

#### Common Use Cases

Here are some common use cases of the Amazon S3 integration:

* Archiving a signed loan package to the lender's S3 bucket at closing
* Pulling a newly received referral into the patient record for automated intake
* Sending a claimant a secure link to upload damage photos directly to an S3 bucket

***

## How the Amazon S3 Integration Works

Before you configure the Amazon S3 integration, it's important to understand how it functions at a conceptual level.

### Connection Model

Connecting to Amazon S3 from <code class="expression">space.vars.Kizen\_company\_name</code> requires an Amazon Web Services (AWS) account with at least one S3 bucket. During integration setup, you create an IAM user for the integration in your AWS account and attach an IAM policy to this user, which governs what the integration can do with your S3 files and how it can use your storage space. Because the integration doesn't utilize an authorization protocol like OAuth, you must also create an AWS access key for this user, which grants them access the designated files and buckets.

<code class="expression">space.vars.Kizen\_company\_name</code> keeps your connection credentials to Amazon S3 as an integration secret. The same secret can hold the credentials for multiple S3 environments, such as production and archive. Specify the environment in which to work at each S3 step of the <code class="expression">space.vars.automation</code>.

For more information, see [Set Up Amazon S3 in Kizen](/docs/integrations-and-plugins/integrations/amazon-s3/set-up-amazon-s3-in-kizen.md).

### Authentication

Your AWS access key doesn't normally require reauthorization. However, if you rotate or revoke the key manually, S3 actions in <code class="expression">space.vars.Kizen\_company\_name</code> fail with an invalid access key error. To reauthorize, supply a new access key.

### Account Type

A standard AWS account is sufficient to use the integration. You don't need a special membership tier.

### Network

No additional network configuration is required to use the integration. You don't need to set your firewall to allow inbound TCP traffic from a specific port, and you don't need to add <code class="expression">space.vars.Kizen\_company\_name</code>'s egress IP address to any AWS allowlist. Access is governed entirely through your PAT and Unity Catalog permission grants.

### Input Handling

The Upload File action takes as an optional input the API name of the Amazon S3 storage class of the file to upload. For a complete list of S3 storage classes and their API names, see the [Amazon Simple Storage Service documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html).

### Output Handling

The List Files action returns a stringified JSON array, not a native array. Parse the results with a JSON Parse step in the <code class="expression">space.vars.automation</code> before use.

The action also has a hard limit of 50,000 characters per result. If a list of files would exceed this limit, the step fails without returning any of the files on the list. To avoid this error, target the query with the action's filters. See [Troubleshoot Amazon S3](/docs/integrations-and-plugins/integrations/amazon-s3/troubleshoot-amazon-s3.md) for more information.

### Error Handling

If an S3 step of an <code class="expression">space.vars.automation</code> fails, the integration waits a short time and makes a second attempt. If the second attempt fails, the <code class="expression">space.vars.automation</code> fails.

***

## How to Use the Amazon S3 Integration

For step-by-step instructions on using the Amazon S3 integration, see the following topics:

* [Set Up Amazon S3 in Kizen](/docs/integrations-and-plugins/integrations/amazon-s3/set-up-amazon-s3-in-kizen.md)
* [Work with Amazon S3 Files in an Agentic Workflow](/docs/integrations-and-plugins/integrations/amazon-s3/work-with-amazon-s3-files-in-an-agentic-workflow.md)
* [Troubleshoot Amazon S3](/docs/integrations-and-plugins/integrations/amazon-s3/troubleshoot-amazon-s3.md)

***

## What's Next

Continue to [Set Up Amazon S3 in Kizen](/docs/integrations-and-plugins/integrations/amazon-s3/set-up-amazon-s3-in-kizen.md) to configure the connection.&#x20;

<details>

<summary><strong>Related Topics</strong></summary>

* [Set Up Amazon S3 in Kizen](/docs/integrations-and-plugins/integrations/amazon-s3/set-up-amazon-s3-in-kizen.md)
* [Work with Amazon S3 Files in an Agentic Workflow](/docs/integrations-and-plugins/integrations/amazon-s3/work-with-amazon-s3-files-in-an-agentic-workflow.md)
* [Troubleshoot Amazon S3](/docs/integrations-and-plugins/integrations/amazon-s3/troubleshoot-amazon-s3.md)

</details>

***

*Amazon Web Services, AWS, Amazon Simple Storage Service, and Amazon S3 are trademarks of Amazon.com, Inc. or its affiliates. Kizen's Amazon S3 integration is not affiliated with, sponsored by, or endorsed by Amazon.com, Inc.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.kizen.com/docs/integrations-and-plugins/integrations/amazon-s3.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.