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

# FullStory

> Sync your user properties into FullStory on your schedule, not only when users are interacting with your properties. This allows you to integrate these platforms and gain a more complete view of your customer experience.

## Overview

You've recently built a great digital experience but need to gather information to improve upon the current iteration. How can you know what works and what doesn't? With Hightouch's FullStory integration, you can sync your most recent user properties data to better analyze who is interacting with your product and how. This allows you to make product improvements driven by meaningful data and optimized to enhance retention rates.

## Supported syncing

| Type | Description | Supported Sync Modes |
| - | - | - |
| **Users** | Sync data from any source to Users in FullStory | Update |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to FullStory

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **FullStory** and click **Continue**. You can then authenticate Hightouch to **FullStory** with your FullStory **API key**.

You can find your API key within your FullStory account by clicking the dropdown button on the top left of the page, and opening **Settings** > **API Keys** under the **Integrations** section.

![FullStory API key](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-fullstory-api-key.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=a726a1ccd900d12d1efef8485f579a40)

For more information on FullStory API keys, refer to [FullStory's documentation](https://help.fullstory.com/hc/en-us/articles/360052021773-Managing-API-Keys).

## Sync configuration

Once you've set up your FullStory destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull
data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview
page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and
the FullStory destination you want to sync to.

### Users

Sync data from any source to Users in FullStory.

#### Record matching

Hightouch matches rows from your model to FullStory users by **User ID**. Select the model column that contains these values.

#### Field mapping

You can sync columns from your source to the following FullStory user fields:

* **Display Name**
* **Email**

#### Custom mapping

You can sync to existing FullStory custom fields or create them via field mapping. When entering new custom fields, ensure the field is named using the pattern `ident_type`,
where `ident` is a sequence of alphanumeric characters `A-Z`, `a-z`, or `0-9` and `type` is a short suffix that denotes the field type. Custom field names must start with an alphabetic character (`A-Z` or `a-z`).

Example acceptable field names includes `nickname_str`, `PasswordResets_int`, and `amtAbandonedInCart_real`.
Refer to the FullStory [docs](https://help.fullstory.com/hc/en-us/articles/4446290296599-Setting-custom-API-properties) for more details.

#### Delete behavior

| Behavior | Description |
| - | - |
| **Do nothing** | Keep the customer record in FullStory with all its synced fields |
| **Clear** | Unset some mapped fields from FullStory |

> [!NOTE]
>
> Hightouch can only clear fields of type `_str`, `_real`, and `_int`. Hightouch sets the
> cleared result of `_str` field type to an empty string (`""`) and the
> cleared result of `_real` and `_int` to `0`.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).
