Skip to main content
Shopify will be deprecating their REST API and recommends their new GraphQL API. Hightouch supports using these new GraphQL endpoints for new syncs, and existing syncs can be updated to use the GraphQL endpoints.

​
Overview

This destination lets you send customer, product, and fulfillment information from your data warehouse to Shopify so you never have to worry about stale inventory information or incorrect customer or product details.

​
GraphQL vs REST API

Shopify will be deprecating their REST API in favor of their new GraphQL API. For more detailed information on this update, and how object types and inputs have changed, refer to this Shopify resource. Hightouch allows syncs to use either protocol for the time being, and you can change between the two protocols to see the differences between them. Most notably, the GraphQL endpoints use new object types Product Variant and Product Option that were previously coupled together for the REST API. They are now separate Object types to sync to based on existing Products in your shop.

​
Supported syncing

​
Connect to Shopify

Go to the Destinations overview page and click the Add destination button. Select Shopify. To connect your Hightouch app to Shopify, you need to create a custom app in your Shopify account.
Shopify requires that custom apps made after January 1, 2026 be authenticated to using Client credentials. Custom apps made before January 1, 2026 can be authenticated to using an Admin API access token. If you are creating a new custom app, please use the Client credentials flow. If you have an existing custom app, you may use the Admin API access token flow.
You then need to provide your Store name and either the set of Client credentials or an Admin API access token of your custom app.

​
Create Client credentials for your custom app

  1. In your Shopify store’s home page, click Apps on the sidebar. Creating an app in the Shopify home page
  2. Click on Develop apps and then select Build apps in Dev Dashboard. Develop apps button in Shopify Build apps in Dev Dashboard button in Shopify
  3. Click Create app and go through the flow using the Start from Dev Dashboard option. Shopify apps page Shopify create an app page
  4. Add to the Access > Scopes section the scopes:
  1. Click Release and under the Settings tab you will find your Client ID and Client secret. Shopify Custom app client credentials

​
Create an Admin API access token for your custom app

  1. In your Shopify store’s admin, click Apps in the left sidebar.
  2. From the dropdown which appears, select Apps and sales channel settings.
Creating an app in the Shopify admin
  1. Click Develop apps for your store.
  2. On the next screen, click Create an App in the top right corner. Give it a descriptive name, for example, “Hightouch integration.” Then click Create app.
  3. Under Configuration tab, select Configure to configure the Admin API Integration.
Configuring an Admin API token
  1. Select the following Admin API access scopes:
    • write_customers
    • read_customers
    • write_discounts
    • read_discounts
    • write_inventory
    • read_inventory
    • write_price_rules
    • read_price_rules
    • write_products
    • read_products
    • read_locations
    • write_assigned_fulfillment_orders
    • read_assigned_fulfillment_orders
    • write_merchant_managed_fulfillment_orders
    • read_merchant_managed_fulfillment_orders
    • write_fulfillments
    • read_fulfillments
    • write_orders
    • read_orders Required scopes in the Shopify Admin
  2. Click Save in the bottom right of the screen.
  3. In API Credentials tab, click Install app, and then Install in the modal that appears.
  4. Your Admin API Access Token is now available. Copy and save your Admin API access token in a secure place.

​
Sync configuration

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

​
Objects

Hightouch supports syncing to these Shopify objects with the following sync modes: Check out the sync modes docs to learn more.

​
Record matching

Based on the Shopify object, database records can be matched from your source to your Shopify workspace by a unique property.

​
Field mapping

You can sync columns from your source to Shopify’s default and custom fields.
You must provide a Price Rule ID from an existing PriceRule when syncing Discounts. Similarly, you must provide an Inventory Item ID from an existing Product when syncing either Inventory Item or Inventory Level.

​
Delete behavior

For Products (for the REST API protocol only), you can choose what Hightouch’s behavior is when a record leaves the query result set.

​
Events

Hightouch supports syncing to these Shopify events with the following sync modes:
To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

​
Field mapping

You need to include at least the Fulfillment ID, Order ID, and Status in your sync. Other field mappings are optional.

​
Actions

Hightouch supports syncing to these Shopify events with the following sync modes:
To ensure syncs send each action, your event model must use a truly unique primary key. See the events syncs documentation for more information.

​
Field mapping

Each action requires you to include at least the Fulfillment Order ID. Some actions require additional fields:

​
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, .
For Hightouch platform error codes related to destinations, see Error codes.

​
Validate your setup

After you configure your sync, run a test to confirm data flows correctly:
  1. Start with a small test audience or a single record.
  2. Trigger a manual sync from the Syncs overview page.
  3. After the sync completes, verify the data in Shopify:
    • For customer syncs, go to Customers in Shopify Admin and search for the test customer. Confirm that the mapped fields appear with the expected values.
    • For product syncs, go to Products and verify the synced product attributes.
  4. If the sync shows errors, check the sync run log in Hightouch for specific API error messages.

​
Tag sync behavior

When syncing tags to Shopify, Hightouch replaces the entire tag list on the resource with the tags in your sync payload. This means that if you sync a single tag, any existing tags not included in the payload are removed. To preserve existing tags, include all desired tags in your model’s tag column — not just the new ones you want to add.

​
Variants field formatting

When syncing product variants, the Variants field expects an array of objects. In your model, ensure the column is cast to the Object/Array data type — not String. Each object in the array represents a single variant. For example, the column value should look like:
If the column is a string, cast it to Object/Array in your model configuration, or use your warehouse’s JSON functions to construct the array in your SQL model.
Last modified on June 10, 2026