> ## 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.

# User Interviews

> Gain deeper understanding of your custom participants with User Interviews

## Supported syncing

| Type | Description | Supported Sync Modes | API Reference |
| - | - | - | - |
| **Participants** | Sync data from any source to User Interviews participants | Upsert, Update, Insert | [Participants endpoint](https://api-docs.userinterviews.com/reference/patch_api-participants-batches) |

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 User Interviews

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **User Interviews** and click **Continue**. You can then authenticate Hightouch to **User Interviews** by entering the following required fields into Hightouch:

* **API key**: The User Interviews API key to authenticate requests. See [obtaining an API key](https://api-docs.userinterviews.com/reference/authentication#obtaining-an-api-key) for information on how to get your API key.
* **Environment**: **Sandbox** or **Production**.

## Sync configuration

Once you've set up your User Interviews 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 User Interviews destination you want to sync to.

### Syncing participants

Update existing participants' fields and characeristics, insert new participants, or do both with upsert mode.

#### Record matching

To match rows from your model to participant in User Interviews, you need to select the model column that contains values that match the particpants' **email** field. Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

> [!NOTE]
>
> In **Insert** mode, User Interviews automatically generates an identifier for every new record synced, so there is no need to match an existing record.

#### Field mapping

Hightouch lets you sync participant fields via [field mapping](https://docs.hightouch.com/syncs/mapping-data.md).
You can map data from any of your model columns to default participant fields and characteristics.
Ensure your model columns data types match the data types of the fields you want to sync to.

#### Delete behavior

The [delete behavior](https://docs.hightouch.com/syncs/overview.md#delete-behavior) you select dictates what to do when a row no longer appears in your model's query results. You have the following options:

> [!NOTE]
>
> **Delete** is only available for **Upsert** mode and **Clear** is available for
> **Upsert** and **Update** mode.

| Behavior | Description |
| - | - |
| **Do nothing** | Keep the participant in User Interviews with all its synced fields |
| **Clear** | Clear all the mapped fields, but keep the participant in User Interviews |
| **Delete** | Delete the synced participants from User Interviews |

#### Split retries

User Interviews counts all participants in a batch as rejected if the request contains a single invalid participant. To pinpoint which participants are getting rejected with which errors and reduce the number of valid participants that get retried, you can enable [split retries](https://docs.hightouch.com/syncs/retries.md#split-retries).

## 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).