> ## Documentation Index
> Fetch the complete documentation index at: https://support.amplify.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon S3 Integration

Connect your Amazon S3 account to Amplify to automatically sync your fax documents and related metadata to your S3 bucket. This makes it easier to securely store fax records and use them with external systems and automated workflows.

## What gets synced

Once your Amazon S3 integration is connected, Amplify automatically syncs your inbound and outbound fax documents along with their corresponding metadata.

### Inbound faxes

For each inbound fax, Amplify uploads:

* A PDF file containing the fax document
* A JSON file containing the fax metadata

The metadata can include:

* Fax ID
* Caller ID
* Sender ID
* Page count
* Timestamps
* Fax status

### Outbound faxes

For each outbound fax, Amplify uploads:

* A PDF file containing the fax document
* A JSON file containing the fax and delivery information

The metadata can include:

* Fax ID
* Delivery status
* Page count
* Timestamps
* Retry information
* Error details, when applicable

Each fax is stored using its fax ID:

`<faxid>.pdf`

`<faxid>.json`

## Set up Amazon S3

To connect your Amazon S3 bucket:

1. Go to **Settings**.
2. Select **Integrations & Plugins**.
3. Under **File Storage**, select **Amazon S3**.
4. Enter the following S3 configuration details:
   * **Bucket Region** — Select the AWS region where your S3 bucket is hosted.
   * **Bucket Name** — Enter your S3 bucket name.
   * **Access Key** — Enter your AWS access key.
   * **Secret Access Key** — Enter your AWS secret access key.
   * **Folder Prefix** — Optionally enter a folder path where you want your fax files to be stored.
5. Under **Failure Notification**, enter one or more email addresses that should receive notifications if a file cannot be uploaded.
6. Save the configuration to connect your Amazon S3 bucket.

Make sure the AWS credentials you provide have the required permissions to upload files to the selected S3 bucket.

## Sync your fax documents

After your Amazon S3 bucket is successfully connected, Amplify automatically synchronizes your fax documents with the configured bucket.

Your fax PDFs and their corresponding JSON metadata files are uploaded to Amazon S3 as they become available.

If you organize your fax documents into folders in Amplify, changes to the folder structure are also synchronized with your S3 bucket.

This includes:

* Creating a folder
* Creating a child folder
* Moving a fax document between folders
* Renaming a folder
* Deleting a folder

Changes are synchronized dynamically so that your S3 storage stays aligned with the organization of your fax documents in Amplify.

## Sync an existing folder structure

When you connect an Amazon S3 bucket, Amplify creates the corresponding folder structure in the bucket and synchronizes your fax documents and folders.

You can also open a synced fax document directly from your Amazon S3 bucket after synchronization.

If synchronization is already in progress, attempting to start the sync again will notify you that the synchronization is currently underway.

## Failure notifications

If Amplify cannot upload a fax document or its metadata to your Amazon S3 bucket, the system automatically retries the upload for up to **7 days**.

If the upload continues to fail:

* Amplify sends a failure notification to the email address or addresses configured for the integration.
* Amplify Support is also notified.
* Only one failure notification is sent for the issue while the system continues retrying, so you do not receive duplicate notifications for the same failure.

If the failure is caused by incorrect or invalid configuration details, verify your S3 bucket information and AWS credentials and update the integration.

## Disconnect Amazon S3

You can disconnect your Amazon S3 integration from **Settings > Integrations & Plugins**.

If your Amplify account is currently syncing with the connected S3 bucket, Amplify will notify you before the integration is removed.

Once the integration is disconnected, new fax documents and metadata will no longer be synchronized to the S3 bucket.