Search documentation...

ChangelogBook a demoSign up


Empower your product teams with richer data from your warehouse to perform deeper analysis and better understand user behavior

Supported syncing

TypeDescriptionSupported Sync Modes
ObjectsSync records to objects such as users or organizations in AmplitudeUpsert
EventsSync records as events to Amplitude. This is often in the form of a track callInsert

For more information about sync modes, refer to the sync modes docs.

Connect to Amplitude

Go to the Destinations overview page and click the Add destination button. Select Amplitude and click Continue. You can then authenticate Hightouch to Amplitude by entering these fields into Hightouch:

  • API Key: You can find your API key by following these instructions in Amplitude's docs.
  • Region: This is either a Standard server or EU residency server.

Once you've entered these fields, click Continue. Give your destination a descriptive name and Finish the destination connection setup.

Sync configuration

Once you've set up your Amplitude destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Amplitude destination you want to sync to.


Hightouch can sync data to either User and Group objects. A dropdown is available to select between Users and Groups when configuring an Amplitude sync.

This integration only supports the Upsert mode. In this mode, Hightouch inserts new users or groups into Amplitude and keeps all user attributes up-to-date.

Record matching

Hightouch matches rows from your model to Amplitude users by Amplitude User ID or Amplitude Device ID. Select the model column that contains these values if you are syncing user objects. See Amplitude's docs for more on identifying users.

Hightouch matches rows from your model to Amplitude groups by Group Value. Select the model column that contains these values if you are syncing groups.

Field mapping

You can sync columns from your source to Amplitude's default and custom fields. User properties only apply on the next event after the property has been changed, and don't apply retrospectively. For more information, check out Amplitude's FAQ.

Delete behavior

The 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 for Amplitude objects:

Do nothingKeep the customer or group record in Amplitude with all its synced fields
ClearRemove all the mapped fields, but keep the record in Amplitude


To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

Hightouch supports sending events of a given name, for example, Signed Up. Enter this name and choose the model column containing the either user ID or device ID. You can also select the model column containing the event timestamp. If the timesamp field is empty, Hightouch uses the time the event arrives at the server.

Hightouch accepts a normal date time format for the timestamp, and automatically converts it to the format required by Amplitude.

Field mapping

Hightouch allows you to pass data to the default properties and the custom event properties of an Amplitude event.

Tips and troubleshooting

Common errors

To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.

Live debugger

Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.

Sync alerts

Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Last updated: Mar 27, 2023

On this page

Supported syncingConnect to AmplitudeSync configurationObjectsEventsTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?