The Shopify Integration enables you to automatically sync Shopify data, execute personalised e-commerce marketing campaigns and analyse them.

Create Xtremepush private app

Log in to your Shopify account, navigate to Apps and click on Manage private apps button from the Apps section.

Click on Create new private app.

In this page, you need to fill App details, by entering a descriptive name and the responsible technical person's e-mail address in the appropriate fields, then assign the relevant level of Admin API permissions and click Save.


Permissions required

For a functional Shopify integration, you need the following user permissions: read and write access for Customers, read access for Draft orders and read access for Orders.

After saving your integration, Shopify will generate your API key and password to use in the Xtremepush platform in order to complete your integration.

Connect to Shopify

Once you complete the Shopify steps above, open a new tab in your browser and log-in your Xtremepush account. Navigate to Integrations > Marketplace, select the Shopify card in the Integrations Marketplace tab and click Connect.

The Shopify Integration needs Connection, Data Mapping and Realtime Events steps to complete it.


In this section, you need to enter basic and connection details.

Basic settings

Give your connection a Name that helps you easily identify it.

Connection settings

Go back to the Private apps section in your Shopify account and retrieve the connection details. You will need the Access Token (API Key), Password, and also your Store URL (

After completing the connection details, select Fetch Shopify Attributes, which retrieves the data schema, then click Next and navigate to the Data Mapping tab.

Data mapping

In this section, you will list your automatically mapped system attributes, to select which standard attribute to import and also to map your Shopify custom attributes to Xtremepush custom attributes.

Xtremepush's system attributes such as user_id and email will be automatically mapped to Shopify legacyResourceId and email attributes (listed in the Column fields). On the other hand, you will see Shopify standard attributes (listed in the Column fields) selected as Import (listed in the Map to fields). You can decide which attribute to fetch by selecting the Import or Don't Import field from the drop list. Lastly, you will also see Shopify custom attributes (listed in the Column fields) such as firstName, lastName, lastOrder etc. You can also map these attributes to your predefined Xtremepush custom attributes.


Email subscription data

In order to gather email subscription data, you need to map Shopify's acceptsMarketing attribute to Xtremepush's email_subscription attribute.


Creating attributes

System attributes and standard attributes are automatically created on Xtremepush. However, in order to map custom attributes you need to create these attributes on the Xtremepush system first. Review our Attributes & tags guide to see how to do so.

Once you've completed the data mapping, click Next to navigate to the Realtime events tab.

Realtime events

In this section, you are required to select realtime events that you want to use in your campaigns. You can enable checkout, customer, draft order, order, order transaction and refund related events. When you enable an event, you will be able to use it in your campaigns as it will be automatically created as a custom event on the Xtremepush platform when that event is triggered from Shopify,

These events can be used when you create event triggered campaigns and use them within segmentation, for example check-out abandonment, welcome mailing for first time buyers etc.


Events naming

Events will use their naming from Shopify. For example; orders/create, customers/update, orders/partially_fulfilled etc. You can check available event naming from here.

Once you have selected the required events, click Connect. The connections are made and confirmed, your Shopify integration is listed under the Configured Integrations tab within the Marketplace and you are presented with the Integration Details page.

Your final step, in order to start synchronisation, click the Actions drop list and select Sync. Once complete, each profile attribute is displayed along with a timestamp and status os Completed. If there is any other status, click the More menu and choose Details for extended information.

Did this page help you?