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

# Resonate

> Resonate tells you who your highest-value audiences are and what they’ll do next so you can act with precision, before the competition.

## Overview

Resonate is an audience intelligence platform that helps brands activate first-party data for targeting and match enrichment. With the Resonate destination, you can sync customer data from your data warehouse to Resonate via SFTP, enabling audience matching and activation.

## Supported syncing

* **All**: Sends all records in your model every time the sync runs.
* **Insert**: Sends only new records added since the last sync.

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 Resonate

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Resonate** and click **Continue**.

You will need the following credentials from Resonate:

* **Username**: Your Resonate SFTP username.
* **Private Key**: The SSH private key for SFTP authentication. Provide the full private key including the header and footer.
* **Private Key Passphrase** *(optional)*: The passphrase for your private key, if applicable.

> [!NOTE]
>
> Resonate uses SSH key-based authentication. Contact your Resonate account representative to obtain your SFTP credentials and private key.

Hightouch connects to Resonate's SFTP server at `sftp.resonate.com` on port 22. Files are automatically placed in the `data-append/inbound/` directory.

## Sync configuration

Once you've set up your Resonate 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. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button. Select the relevant model and the Resonate destination.

### Field mapping

Map columns from your model to Resonate's required fields. **Customer ID is required** for every sync. You must also include at least one identifier group:

| Field | Required | Notes |
| - | - | - |
| **Customer ID** | Yes | Your internal customer identifier |
| **Email/HEM** | Pair with HEM Type | Emails are automatically hashed (MD5 preferred). Map both HEM and HEM Type together |
| **HEM Type** | Pair with HEM | The hash type of the email (e.g. MD5, SHA-1, SHA-256) |
| **MAID** | One of the identifier groups | Mobile advertising identifier |
| **Address Line 1** | All address fields required together | Street address |
| **Address Line 2** | Optional | Secondary address (apartment, suite, etc.) |
| **City** | All address fields required together | City |
| **State** | All address fields required together | State |
| **Zip Code** | All address fields required together | 5-digit ZIP code |
| **ZIP11** | One of the identifier groups | 11-digit ZIP+4 code |
| **IP Address** | One of the identifier groups | IPv4 format |

> [!WARNING]
>
> HEM and HEM Type must be mapped together — you cannot map one without the other. Similarly, if you map any postal address field, all required address fields (Address Line 1, City, State, Zip Code) must be mapped.

> [!NOTE]
>
> Hightouch automatically hashes email values in the HEM field using MD5 (preferred), SHA-1, or SHA-256. You do not need to pre-hash emails before syncing.

### Data quality options

**Remove Duplicates**: When enabled, duplicate rows based on Customer ID are automatically removed before writing to the file.

**Skip Invalid Rows**: When enabled, rows missing required identifiers (Customer ID + at least one identifier group) are skipped rather than causing sync errors.

## File format

Resonate requires CSV files. Hightouch automatically handles file naming and placement:

* **Directory**: `data-append/inbound/`
* **File naming**: `{ModelName}_{SegmentName}_{YYYYMMDD}_{syncRunId}.csv`

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

### Match rate

Resonate targets a 60–80% match rate. To maximize match rates:

* Include complete postal address (Address Line 1, City, State, Zip Code) when available — this is Resonate's strongest identifier.
* Ensure email addresses are lowercase and trimmed before syncing. Hightouch handles hashing automatically.
* Remove inactive, duplicate, and low-quality records from your model before syncing.
* Suppress international records, business addresses, and P.O. boxes.

### Data requirements

Resonate enforces the following data quality requirements:

* Emails must be lowercase with no leading or trailing spaces (Hightouch hashes them automatically).
* Records missing consent should be excluded from your model.
* International records, business addresses, and P.O. boxes should be suppressed.