# Add a New Destination

To add a new **Destination**, follow these steps:

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

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

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

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

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

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

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

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

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

This will open a list of available destination types on the right-hand side. Select the appropriate destination type for your needs. The available options include:

* Cloud Storage
* File Storage
* Database
* Facebook
* Email
* Google

<figure><img src="/files/6ROBIoULnqdDCyzkhguo" alt=""><figcaption></figcaption></figure>

### Overview of Destination Types <a href="#overviewofdestinationtypes" id="overviewofdestinationtypes"></a>

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

A cloud-based repository for securely storing and retrieving structured or unstructured data.

**AWS S3** acts as a connector by enabling seamless data transfer and integration with various applications, allowing users to store and retrieve data directly from S3 buckets.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationfive.png) Click **AWS S3**.

Click on **Select Destination Type.**

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

This will open a list of available Destinations on the right-hand side. Click AWS **S3.**

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

Click **Select Connector**. The **Select Connectors** panel opens on the right side.

Choose one of the following options to select or create a connector:

* **Browse the list**: Scroll through the available connectors and select the desired one.
* **Use the search bar**: Enter the connector name in the search bar and select it from the results.
* **Create a new connector**: Click **Create Connector** to configure a new connector.

<figure><img src="/files/94SEKMGjleIIw5xBctmZ" alt=""><figcaption></figcaption></figure>

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

**Destination Properties**

**AWS Region**: Denotes the destination region.&#x20;

Under the **AWS Region** section, click the **Select** dropdown.

Choose the appropriate region from the available options:

* **AWS Ohio (us-east-2)** – Located in the United States, suitable for North American workloads.
* **AWS Mumbai (ap-south-1)** – Located in India, ideal for applications serving South Asia.

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

**Bucket Name**: Denotes the name of the **Destination Bucket**.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationbucket.png)

**Object Key**: Refers to the unique identifier for the object in the destination, which is provided by the client.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinatonobjectkey.png)

**Data Format**

Under the **Data Format** section, click the **Select** dropdown to choose the appropriate format type.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationdataformat.png)

**File Format**

* **Compression Type**: Select the compression format to be uploaded to the destination.
* **Content Encoding**: Select the content encoding from this dropdown menu.
* **Encryption Type**: Select the encryption type to encrypt the data. Add the Encryption Key.
* **Note**: Select 'None' if no encryption required.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationfilefarmat.png)

Click **Save** to save the **Destination** details.

**Note**: If mandatory fields are not entered, an error message will be displayed.

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

**SFTP** connectors enable secure file transfers between external SFTP servers and AWS storage services.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationseven.png) Click **SFTP**.

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

Click on **Select Connector** under the **Connector** section to choose the appropriate connector.

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

When you click the **Select Connector** tab, the panel opens on the **right side**. Click the **Search bar** to search for a connector or click **Create Connector** to create a new one.

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

**Destination Properties**

Click **Directory Path** and enter the appropriate directory path to the destination.

Click **File Pattern** and provide the appropriate file pattern for the destination.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationsetpfileformat.png)

Under the **Data Format** section, click the **Select** dropdown under **Format Type**.

Two options will be displayed:

* Delimited - Data is structured using a specific delimiter (e.g., comma, tab, or pipe) to separate values, commonly used in CSV files.
* JSON Format- Data is stored in **JavaScript Object Notation (JSON)**, a lightweight and readable format that organizes data using key-value pairs.

Choose the appropriate option.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationdataformatsize.png)

**File Format**

* **Compression Type**: Select the compression format to be uploaded to the destination.
* **Content Encoding**: Select the content encoding from this dropdown menu.
* **Encryption Type**: Select the encryption type to encrypt the data. Add the Encryption Key.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationsetpfinal.png)

Click **Save** to save the Destination details.

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationeight.png) Click **Postgres**.

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the Search bar to search for a connector or click **Create Connector** to create a new one.

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

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

**Destination Properties**

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

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationsaveedit.png)

Click **Save** to save the Destination details.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationnine.png) **Ingest Labs - Offline Conversions**

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the **Search bar** to search for a connector or click **Create Connector** to create a new one.

<figure><img src="/files/8IX7t6iTAA54sOfhhbnw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2LJ5bihLJgVcAWB9iw53" alt=""><figcaption></figcaption></figure>

**Destination Properties**

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

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationsavecopy.png)

Click **Save** to save the Destination details.

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/indestentlapfacebook.png) **Facebook Audience**

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the **Search bar** to search for a connector or click **Create Connector** to create a new one.

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

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

**Destination Properties**

Click the **Audience ID** section to provide the appropriate ID.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationsave1.png)

Under the **Action** section, click the Select dropdown. The following options will be displayed:

* Add - Adds new data to the existing audience without removing any existing records.
* Replace - Replaces the entire audience with the new data, removing all previous records.

Select the appropriate option.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationaction.png)

Under the **Data Format** section, click the **Select** dropdown under **Format Type**.

Two options will be displayed:

* Delimited - Stores data in a structured format where values are separated by a specific character
* JSON Format - Uses **JavaScript Object Notation (JSON)** to store data in a hierarchical key-value format, commonly used for APIs and data exchanges due to its readability and flexibility.

Choose the appropriate option.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationdatafotmat2.png)

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/indestentlapfacebook.png) **Facebook Conversion API**

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the **Search** bar to search for a connector or click **Create Connector** to create a new one.

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

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

**Destination Properties**

Click the **API Version** field and enter the appropriate version.

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

Under **Data Format**, click the **Format Type** dropdown and select the appropriate option.

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

### Email <a href="#email" id="email"></a>

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationemailattachment.png) **Email Attachment**

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the **Search** bar to search for a connector or click **Create Connector** to create a new one.

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

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

**Destination Properties**

Click the **Attachment File Name** field and enter the appropriate name.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destination1.png)

Click the **Attachment Size Limit (in MB)** field and enter the appropriate limit.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destination2.png)

Click the **Email IDs** dropdown. When the **Add** button is displayed, click the **Add** button.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationemail.png)

Click the **Email ID** section to add the appropriate email address.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationemailids.png)

Click the **Display Name** section to add the appropriate name.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationemainname.png)

Click the **Add More** button to add additional email IDs and names.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationaddmore.png)

Click the **Email Subject** dropdown and select the appropriate subject.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationemailsubject.png)

Click the **Content** section to provide the appropriate content.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationconent.png)

Click the **Body** section dropdown to select the appropriate option.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationconent.png)

Under **Content Type**, click the **Select** dropdown. The following options will be displayed:

* HTML - Supports rich formatting, including text styles, images, links, and structured content using Hypertext Markup Language (HTML).
* Plain Text - Contains only unformatted text without any styling, images, or links, ensuring simple and clean content.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationcontenttypehtml.png)

Click the **Placeholders** dropdown and select the appropriate placeholder.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationplaceholder.png)

Under the **Placeholder Type** section, click the **Select** dropdown. The following two options will be displayed:

* STRING - A sequence of characters (letters, numbers, or symbols) used for text-based placeholders.
* DATE - A placeholder specifically for date values, ensuring the data follows a valid date format.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationplaceholderone.png)

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationentername.png)

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

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationvalue.png)

Click the **Add More** button to add more placeholders.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/placeholdersestination.png)

Click the **Data Format** dropdown and select the appropriate format.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationdataformatone.png)

Under the **Format Type** section, click the **Select** dropdown. The following options will be displayed:

* Delimited - Stores data in a structured format where values are separated by a specific character (e.g., comma in CSV files or tab in TSV files), making it easy to process in spreadsheets and databases.
* JSON Format - Uses **JavaScript Object Notation (JSON)** to store data in a hierarchical key-value format, commonly used for APIs and data exchanges due to its readability and flexibility.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationformatetypetwo.png)

Click the **File Format** dropdown and select the appropriate file format.

Under the **Compression Type** section, click the dropdown. The following options will be displayed:

* None - No compression is applied; the file remains in its original format.
* Zip - Compresses the file into a **.zip** format, reducing file size and allowing multiple files to be packaged together.
* Gzip - Compresses the file into a **.gz** format, commonly used for single-file compression, especially in Linux environments and data transfers.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationnonefilesave.png)

Under the **Content Encoding** section, click the dropdown. The following options will be displayed:

* UTF-8 - A widely used character encoding that supports a vast range of characters, including special symbols and multilingual text.
* ASCII - Simpler encoding standard that supports only basic English characters (letters, numbers, and symbols) and is limited to 128 characters.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationcontenttypeut.png)

Under the **Encryption Type** section, click the dropdown. The following options will be displayed:

* None - No encryption is applied; the data remains in its original, readable format.
* PGP (Pretty Good Privacy) - Encrypts the data using PGP encryption, ensuring secure data transmission and protection against unauthorized access.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationfinalimage.png)

Click **Save** to save the Destination details.

### Google <a href="#google" id="google"></a>

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationgoogleattachment.png) Click **GA4 Measurement Protocol**.

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

When you click the **Select Connector** tab, the panel opens on the right side. Click the Search bar to search for a connector or click **Create Connector** to create a new one.

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

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

**Destination Properties**

Under **Data Format**, click the **Format Type** dropdown to select the appropriate format for your data export.

![Save Destination](https://stg.ingestlabs.com/docs/images/customerdataplatformimages/destinationfin.png)

Click **Save** to save the **Destination** details.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FQUiMEFd0G9YfyLnHe8km%2Fadd%20a%20destination.mp4?alt=media&token=59290866-4f3e-486e-b300-04e6690e0d8f>" %}


---

# Agent Instructions: 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/destinations/add-a-new-destination.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.
