Search documentation...

K

Shopify

Keep your storefront up-to-date with the latest customer and product info from your data warehouse

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.

Supported syncing

Object TypeDescriptionSupported Sync Modes
ObjectsSync data from any source to customer, discount, inventory item, inventory level, product, and fulfillment objectsVaries depending on object
EventsSend fulfillment events to ShopifyInsert
ActionsSync data from any source to any various Shopify actionsInsert

Connect to Shopify

Go to the Destinations overview page and click the Add destination button. Select Shopify. You then need to provide an Admin API Access Token and your Store Name.

Create Admin API access token

  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, "Hightough 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
    • write_assigned_fulfillment_orders
    • read_assigned_fulfillment_orders
    • write_fulfillments
    • read_fulfillments
    • write_merchant_managed_fulfillment_orders
    • read_merchant_managed_fulfillment_orders
    • 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:

Object TypeSupported Sync Modes
CustomersUpsert, Update, and Insert
DiscountsUpdate and Insert
Inventory ItemUpdate only
Inventory LevelUpsert, Update, and Insert
ProductsUpsert, Update, and Insert
FulfillmentUpdate and Insert

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.

Object TypeSupported Identifiers
CustomersEmail, ID, or phone
DiscountsID
Inventory ItemInventory item ID
Inventory LevelInventory item ID
ProductsHandle
FulfillmentFulfillment

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, you can choose what Hightouch's behavior is when a record leaves the query result set.

BehaviorDescription
Do nothingKeep the product in your shop
Delete the Shopify productRemove the product from your shop

Events

Hightouch supports syncing to these Shopify events with the following sync modes:

Object TypeSupported Sync Modes
Fulfillment eventInsert only
To ensure syncs send each event, use a hash function for the event model's primary key . The hash should combine all columns, including member ID, timestamp, etc. See the event sync 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:

Object TypeSupported Sync Modes
Cancel fulfillment ordersInsert only
Mark fulfillment orders as incompleteInsert only
Apply fulfillment hold on fulfillment orders with status OpenInsert only
Move fulfillment orders to another locationInsert only
Mark fulfillment orders as openInsert only
Release the fulfillment hold on fulfillment ordersInsert only
Reschedule the time of scheduled fulfillment ordersInsert only
To ensure syncs send each action, use a hash function for the action model's primary key . The hash should combine all columns, including member ID, timestamp, etc. See the event sync documentation for more information.

Field mapping

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

ActionAdditional required fields
Apply fulfillment hold on fulfillment orders with status OpenReason
Move fulfillment orders to another locationNew Location ID
Reschedule the time of scheduled fulfillment ordersNew Fulfill At

Tips and troubleshooting

Common errors

To date, our customers haven't experienced any errors while using this destination. If you run into any issues, . 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.

On this page

OverviewSupported syncingConnect to ShopifyCreate Admin API access tokenSync configurationObjectsEventsActionsTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?