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

# Create and Implement an Amazon S3 Source

## Prerequisite

Before you create an Amazon S3 Source in Zeotap CDP, note that you must have an account with Amazon S3 and the data intended for import to Zeotap CDP resides within that account. Ensure that you have the details of the below components related to your Amazon S3 account before proceeding with this integration.

<CardGroup>
  <Card title="Bucket Name" icon="archive" horizontal href="#bucket-name" />

  <Card title="S3 Bucket Region" icon="map-pin" horizontal href="#s3-bucket-region" />

  <Card title="Folder" icon="folder" horizontal href="#folder" />

  <Card title="Access Token and Secret Access Token" icon="key" horizontal href="#access-token-and-secret-access-token" />
</CardGroup>

### Bucket Name

This is the name of your S3 bucket. You can obtain this information on your Amazon S3 account by navigating to **Buckets**. In the example shown below, **test-adobe-s3-bucket** is the bucket name.

<Frame>
  <img src="https://mintcdn.com/zeotap/nvqTscX2rya8znmd/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_1_(1).png?fit=max&auto=format&n=nvqTscX2rya8znmd&q=85&s=285e645295f67b8e7ed9880ed63f79fe" width="1530" height="822" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_1_(1).png" />
</Frame>

### S3 Bucket Region

This is the geographical location where the Amazon S3 storage is available. You can obtain this information by navigating to the **Properties** tab under the Amazon S3 bucket as shown in the image below.

<Frame>
  <img src="https://mintcdn.com/zeotap/nvqTscX2rya8znmd/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_2_(1).png?fit=max&auto=format&n=nvqTscX2rya8znmd&q=85&s=d4920504cf29017e61b52e67b48d80d6" width="1434" height="956" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_2_(1).png" />
</Frame>

### Folder

In Amazon S3, a folder serves as a logical container for organising stored objects within a bucket. In reality, there are no actual folders in Amazon S3. Instead, the folder concept is emulated by employing object key names containing slashes ("/") to replicate a hierarchical arrangement. You can obtain this information from your Amazon S3 account by navigating to the **Objects** tab under the Amazon S3 bucket as shown in the image below.

<Frame>
  <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_3_(1).png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=6b21f4fa5854f281b445578813dcc048" width="1696" height="1250" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/amazon_s3_pre_3_(1).png" />
</Frame>

### Access Token and Secret Access Token

These are the security tokens that provide secure access to your Amazon S3 resources. You can obtain the Access Token and Secret Access Token by navigating to the **AWS IAM Credentials** tab under **Security credentials** in your Amazon S3 account. Ensure that you have the following permissions to create Access token and Secret access token for your own IAM user:

`iam:ListAccessKeys` – Allows listing the access keys for an IAM user.<br />
`iam:CreateAccessKey` – Allows creating new access keys for an IAM user.

## Create an Amazon S3 Source

Once you have obtained the above details from your Amazon S3 account, perform the following steps to create an Amazon S3 Source in the Zeotap CDP App:

<Steps>
  <Step>
    Navigate to the **Sources** application under **Integrate**, in the Zeotap CDP App.
  </Step>

  <Step>
    Click **CREATE SOURCE**.
  </Step>

  <Step>
    Choose **Data Warehouse** as the Category.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/sf_1_(1).png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=146e94f6110f76970d52baf2ab1e964b" width="3532" height="1784" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/sf_1_(1).png" />
    </Frame>
  </Step>

  <Step>
    Click **Amazon S3** at the Data Source.

    <Frame>
      <img src="https://mintcdn.com/zeotap/5K-Zf-MYwWXwJWp5/articles/integrate-customer/Storage/integrate-customer/create-and-implement-an-amazon-s3-source/create-and-implement-an-amazon-s3-source-2024-10-21.png?fit=max&auto=format&n=5K-Zf-MYwWXwJWp5&q=85&s=7dc9b12703331242ba8c31bc02947e8f" width="3506" height="1744" data-path="articles/integrate-customer/Storage/integrate-customer/create-and-implement-an-amazon-s3-source/create-and-implement-an-amazon-s3-source-2024-10-21.png" />
    </Frame>
  </Step>

  <Step>
    Enter a short and descriptive name for the Source.
  </Step>

  <Step>
    Choose the **Region** of upload.
  </Step>

  <Step>
    Enter **Access Token** and **Secret Access Token** that you obtained from your Amazon S3 account.
  </Step>

  <Step>
    Enter the **Bucket Name** of your Amazon S3 bucket.

    <Frame>
      <img src="https://mintcdn.com/zeotap/nvqTscX2rya8znmd/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/Screenshot_2024-04-02_at_5.17.47_PM.png?fit=max&auto=format&n=nvqTscX2rya8znmd&q=85&s=cf6a61bf985c7b9ed7b9b86b89a5e8ac" width="1404" height="1066" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/Screenshot_2024-04-02_at_5.17.47_PM.png" />
    </Frame>
  </Step>

  <Step>
    Provide the **Folder** path in your storage location where Zeotap CDP can store your exported data.
  </Step>

  <Step>
    Enter the **S3 Bucket Region** associated with the bucket from which you want Zeotap CDP to fetch the data.
  </Step>

  <Step>
    Choose the desired **Sync Frequency**from the drop-down menu. Note that the first sync is initiated once you create the source. However, the subsequent syncs occur based on the sync frequency you choose. Currently, we support the following sync frequencies:

    a. Daily

    b. Weekly

    c. Monthly
  </Step>

  <Step>
    Set **Delta Query Selection** to either **true** or **false** based on your requirement. If you click **Yes**, then Zeotap CDP fetches all the data that has been updated in your S3 bucket after the last data sync between your S3 account and Zeotap CDP.
  </Step>

  <Step>
    Choose the **file type** from the drop-down menu. Currently, Zeotap CDP supports CSV and JSON formats.
  </Step>

  <Step>
    Under **Data Entity**, depending on the type of data you want to ingest, choose either **Customer Data** or **Non Customer Data** and proceed with the Source creation. To know more about Customer Data and Non Customer Data, refer [here](https://docs.zeotap.com/articles/unify-customer/supported-data-entities).

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/image-20240405-074844.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=42017973a6885a1bf840ab4e36c14e70" width="1774" height="1436" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/image-20240405-074844.png" />
    </Frame>
  </Step>

  <Step>
    Click **CREATE SOURCE**. Upon successfully creating the source, you can view all the relevant information about the created source under the **IMPLEMENTATION DETAILS** tab.

    <Frame>
      <img src="https://mintcdn.com/zeotap/nvqTscX2rya8znmd/articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/Amazon_S3_imple.png?fit=max&auto=format&n=nvqTscX2rya8znmd&q=85&s=d9273731356263b27ddb085e1bf1fa4f" width="2854" height="1496" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-amazon-s3-source/Amazon_S3_imple.png" />
    </Frame>
  </Step>
</Steps>
