> For the complete documentation index, see [llms.txt](https://docs.ingestlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ingestlabs.com/media-data-platform/data-sources/add-a-data-source.md).

# Add a Data Source

To add a new **Data Source**, follow these steps:

**Step 1**: In the left navigation panel, click **Data Source**.

<figure><img src="/files/HDVpk9glff2otd4rf8yX" alt=""><figcaption></figcaption></figure>

**Step 2**: Select **Add New Data Source** located at the top-right corner of the screen.

<figure><img src="/files/sBzFYdNNnNI8pfR9JQbY" alt=""><figcaption></figcaption></figure>

**Step 3**: In the **Name** field, enter the name of the **Data Source**.

**Step 4**: In the **Description** field, enter a brief description of the **Data Source**.

<figure><img src="/files/jJy7qzdAG0MX0ykZEEVY" alt=""><figcaption></figcaption></figure>

**Step 5**: Under the **Source Type** section, click **Select Source Type** to choose the appropriate option.

<figure><img src="/files/klinpN20TGFe6Ylaytgi" alt=""><figcaption></figcaption></figure>

**Step 6**: This will open a list of available **Source Types** on the right-hand side. Select the appropriate **Source Type** for your needs. The available options include:

* Cloud Storage
* File Storage
* Database
* Facebook
* Shopify
* Database

### Overview of Source Types <a href="#overviewofsourcetypes" id="overviewofsourcetypes"></a>

### Cloud Storage <a href="#cloudstorage" id="cloudstorage"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourceaws.png) Click **AWS S3**.

Under the **Connector** section, click **Select Connector** to choose the appropriate option.

<figure><img src="/files/7oV6isojAp1LZAVxBaVT" alt=""><figcaption></figcaption></figure>

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

Choose the appropriate connector.

<figure><img src="/files/sm3Lk7pB5BEAO9Yw1tjP" alt=""><figcaption></figcaption></figure>

**Destination Properties**

Under **AWS Region**, click the **Select** dropdown and choose the appropriate region.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcepropertiesone.png)

Click the **Bucket Name** field to enter the appropriate name.

Click the **Object Key** field to enter the appropriate key.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedestinationdescription.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

**File Format**

Under **Compression Type**, click the dropdown to select the appropriate option.

Under **Content Encoding**, click the dropdown to select the appropriate option.

Under **Encryption Type**, click the dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcefileformat.png)

### File Storage <a href="#filestorage" id="filestorage"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcesftp.png) Click **SFTP**.

Under the **Connector** section, click **Select Connector** to choose the appropriate option.

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

<figure><img src="/files/ipkk59eTO0POhFeC3woV" alt=""><figcaption></figcaption></figure>

**Data Source Properties**

Click the **Directory Path** field to enter the appropriate path.

Click the **File Pattern** field to enter the appropriate pattern.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/directorypathone.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

**File Format**

Under **Compression Type**, click the dropdown to select the appropriate option.

Under **Content Encoding**, click the dropdown to select the appropriate option.

Under **Encryption Type**, click the dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcefileformat.png)

### Database <a href="#database" id="database"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcepro.png) Click **POSTGRES**.

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

<figure><img src="/files/PjFslGfQoCHU85IXHwuq" alt=""><figcaption></figcaption></figure>

**Data Source Properties**

Under the **Database Engine** field, click the dropdown to select the appropriate option.

In the **SQL Query** field, enter the appropriate query.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/sqlquery.png)

**Placeholders**

Under the **Placeholders** section, click Add.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverplaceholder.png)

Click the **Name** field to enter the name of the placeholder.

Click the **Value** field to enter the appropriate value.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/placeholdername.png)

Click the **Data Type** dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datatypeselect.png)

Click the **Is an Array?** field dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/placeholderisany.png)

**Note**: By clicking Add More, you can add more items.

**Timestamp Column (To fetch delta set of records)**

Click the **Table Name** field to enter the appropriate name.

Click the **Column Name** field to enter the appropriate name.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/placeholdercolumnname.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

### Facebook <a href="#facebook" id="facebook"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcefacebook.png) Click **Facebook Ads**.

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

<figure><img src="/files/9CgLImxkAQr4RGCFJdN7" alt=""><figcaption></figcaption></figure>

**Data Source Properties**

Click the **Fields** section to enter the appropriate information.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverfields.png)

Click the **Level** dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverlavel.png)

Click the **Time Increment (in days)** field to enter the appropriate value.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasavertimeincrement.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

**File Format**

Under **Compression Type**, click the dropdown to select the appropriate option.

Under **Content Encoding**, click the dropdown to select the appropriate option.

Under **Encryption Type**, click the dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcefileformat.png)

### Shopify <a href="#shopify" id="shopify"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcespotify.png) Click **Shopify Orders**.

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

<figure><img src="/files/VinW6e8yp8jQ6mIGuskZ" alt=""><figcaption></figcaption></figure>

**Data Source Properties**

Click the **Domain** field to enter the appropriate domain.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverdomain.png)

Click the **API Version** dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverapiversion.png)

Click the **Backdated Orders History (in days)** field to enter the appropriate number of days.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/backdatedorders.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

### Database <a href="#database" id="database"></a>

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourceingestlab.png) Click **Ingest Labs - Offline Conversions**.

When you click **Select Connector**, a **Select Connectors** panel opens on the right-hand side. You can either search and select a connector or create a new connector by clicking **Create Connector**.

<figure><img src="/files/0lOtUTP1GR2bXLQHBHmP" alt=""><figcaption></figcaption></figure>

**Data Source Properties**

Click the **Engine Name** field dropdown to select the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasaverenginename.png)

Click the **Table Name** field to enter the appropriate name.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasavertablename.png)

**Data Format**

Under the **Data Format** field, in the **Format Type** section, click the **Select** dropdown to choose the appropriate option.

![Data Source](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/datasourcedataformate.png)

Once you have entered all necessary information, click the **Save** button to save the **Data Source** you’ve created.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FO6HjOptBO9pisYLie0Jp%2FAdd%20a%20screen.mp4?alt=media&token=fdf0a7bd-0c9f-49ae-b57c-bb2cb3e035ba>" %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ingestlabs.com/media-data-platform/data-sources/add-a-data-source.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
