Skip to main content

Supported syncing

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

Connect to Spotify

Go to the Destinations overview page and click the Add destination button. Select Spotify and click Continue. You can then authenticate Hightouch to Spotify. For the Authentication method, select Log in to Spotify and log into your Spotify account. Once successful, you will be redirected back to Hightouch to enter a descriptive name for your destination and complete setup.

Sync configuration

Once you’ve set up your Spotify 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 Spotify destination you want to sync to.

Syncing audiences

Sync data from any source to Spotify audiences.

Select an existing audience or create a new one

You can create a new audience or sync to an existing one. When creating a new audience, you can optionally enter a name. If you leave it blank, Hightouch uses the name of the model. To use an existing audience, select it from the dropdown. Hightouch creates the audience in Spotify during the first sync run. Audience names must be between 2 and 80 characters.

Record matching

You can match rows from your model to audience members in Spotify using any of the supported identifiers. Ensure the data types of the model column and Spotify field you select match. The supported identifiers are:
  • Hashed email (EMAIL_ID_SHA256)
  • Hashed device ID (DEVICE_ID_SHA256)
  • Hashed phone number (PHONE_NUMBER_SHA256) Refer to the record matching docs for more information.

Field mapping

Hightouch lets you sync audience fields via field mapping. You can map data from any of your model columns to the default audience fields. Ensure your model’s columns have the same data types as the fields you want to sync to.

Syncing conversions

Sync data from any source to Spotify conversion events.
To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

Record matching

You can match conversion events to users in Spotify using any of the supported identifiers. Ensure the data types of the model column and Spotify field you select match. The supported identifiers are:
  • Hashed email (hashed_emails)
  • Device ID (device_id)
  • Hashed phone number (hashed_phone_number)
  • IP address (ip_address) Refer to the record matching docs for more information.

Field mapping

Hightouch lets you sync event properties via field mapping.

Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the live debugger. To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up sync alerts. If you run into an issue this page doesn’t cover, .
Last modified on September 21, 2026