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

# Sync data from Hightouch

> Learn how to connect upstream data sources to Unify via Hightouch.

## Overview

<Note>
  This guide assumes that you already have a Hightouch account. If you don't,
  you can sign up for a demo [here](https://hightouch.com/demo).
</Note>

Hightouch provides a destination which allows you to sync data from any
Hightouch-supported data source into Unify objects. Hightouch supports a range
of data sources, including data warehouses, databases, and more.

## Connect Hightouch to Unify

<Steps titleSize="h3">
  <Step title="Select the Unify destination type">
    Within Hightouch, navigate to **Destinations** and select **Add destination**.
    Look for the **Unify** destination type and select it.

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-select-destination.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=b21a8865daab0d9b693d777aa7030ca5" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-select-destination.png" />
    </Frame>
  </Step>

  <Step title="Configure the destination">
    Provide an API key for your destination. You can generate an API key within
    Unify by navigating to [Settings → Developers](https://app.unifygtm.com/dashboard/settings/integrations/api-keys).

    You can verify that the API key is valid and working by selecting **Test connection**.
    You should see a message that says "Successfully connected to Unify".

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-destination-api-key.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=2152a3d22c61ae7aa4f29ee0929c64c4" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-destination-api-key.png" />
    </Frame>

    Next, configure any alerts you want to receive for this destination.

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-destination-alerts.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=f99c34a39882e92cf43f37f59e31f5c6" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-destination-alerts.png" />
    </Frame>

    Lastly, choose a name for your destination, set the desired permissions,
    and select **Finish** to save the destination.

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-destination-finalize.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=2ee4ea8e545a312590888b60dff8deca" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-destination-finalize.png" />
    </Frame>
  </Step>

  <Step title="Save the destination">
    Once saved, you will see this destination listed in the **Destinations** tab.

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-destination-created.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=4bf04be58ef8cfecfd434569e9e229e7" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-destination-created.png" />
    </Frame>

    You can modify the destination settings and test the connection again from
    here.
  </Step>
</Steps>

## Sync to an object

<Steps titleSize="h3">
  <Step title="Create a new sync">
    From the destination or syncs page, select **Add sync**. The first step is
    to select a *model* which represents the data source you want to send into
    Unify. If you haven't configured one yet, head over to **Models** and
    create one.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-select-model.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=ac2616486a9e3a2b8c12b679041bd962" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-select-model.png" />
    </Frame>
  </Step>

  <Step title="Configure sync options">
    Select the Unify destination you created previously. Choose "Records" for
    the first option and then select the Unify object you want to sync records
    to. You can select a "standard" object (e.g., Companies or People) or a
    custom object.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-select-object.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=3be4ce7afc61c5bbbb24f4a89f043921" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-select-object.png" />
    </Frame>

    Once the object is selected, choose whether you want to "upsert" records
    (create and update) or "insert" records (create only).

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-sync-insert-or-upsert.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=2d323467454bfe10c36d0e868074da89" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-insert-or-upsert.png" />
    </Frame>
  </Step>

  <Step title="Select the sync key">
    Choose which unique key to use for the sync. This is the key that will be
    used to identify records in Unify to avoid creating duplicates and to update
    existing records (if applicable).

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-sync-id.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=a9e404edc285b76d4eb160b70eb7e46c" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-id.png" />
    </Frame>

    This must be a unique attribute on the Unify object and in the data source.
    For example, the unique attribute on Companies is `domain`, and the unique
    attribute on People is `email`. On custom objects, you can define your own
    unique attributes.
  </Step>

  <Step title="Map fields">
    The next step is to map fields in your data source to Unify object
    attributes. This defines how record values will be copied over to Unify.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-mapping.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=cb30db45ac749f132e38eaa44addb9ef" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-mapping.png" />
    </Frame>

    Unify objects support *reference* attributes which represent relationships
    between objects. For example, the Person object has a reference attribute
    for the Company that the person works at.

    In the above example, we are mapping our data source to the Person object,
    and we are also linking each person to a Company by mapping Company fields.
  </Step>

  <Step title="Finalize settings">
    Finally, choose how you want to run the sync and then select **Finish**.

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-sync-finalize-settings.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=09898f09bdb9c3c78263957d69fae1c4" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-finalize-settings.png" />
    </Frame>
  </Step>
</Steps>

## Inspect the sync

<Steps titleSize="h3">
  <Step title="Verify running">
    On the sync page, you can see the newly created sync, trigger a run, and
    inspect results.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-ran.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=ac2790d250de930f784d6f5227c21602" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-ran.png" />
    </Frame>
  </Step>

  <Step title="View results">
    Click on a sync run to view the successfully synced records and any errors
    that were encountered.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-summary.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=9dbd272739f96a68eba75c8087a37ca9" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-summary.png" />
    </Frame>

    Select the **Successful** tab to view synced records.

    <Frame>
      <img src="https://mintcdn.com/unify-19/hIdm9AItOuBuD9a5/images/developers/guides/import-data/hightouch/hightouch-sync-successful.png?fit=max&auto=format&n=hIdm9AItOuBuD9a5&q=85&s=f34b9c2cbae643c969892995000ed988" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-sync-successful.png" />
    </Frame>

    You should then see the created records in Unify!

    <Frame>
      <img src="https://mintcdn.com/unify-19/OIfApGfIvPJ-YWJ2/images/developers/guides/import-data/hightouch/hightouch-created-person.png?fit=max&auto=format&n=OIfApGfIvPJ-YWJ2&q=85&s=2abfab72fa745f49425beea7c7a07769" width="2592" height="1842" data-path="images/developers/guides/import-data/hightouch/hightouch-created-person.png" />
    </Frame>
  </Step>
</Steps>
