Create a custom app in the Shopify Dev Dashboard (one-time)

You only need this step if you're connecting via your own app. If you're connecting via the Xendy app, skip ahead to Connect Shopify in Xendy.

  1. Go to dev.shopify.com → Apps → Create app and name the app something like Xendy.
  2. Under Configuration, enable the following scopes and save:
    • read_customers
    • read_orders
    • read_all_orders
    • read_products
  3. Grant the app access to protected customer data (customers' names and email addresses). Without this access, Shopify won't provide customer data. On a Shopify Basic or Starter plan, Shopify does not allow this.
  4. Install the app on your store. The app and the store must be in the same Shopify organization.
  5. Copy the Client ID and the Client Secret. You'll paste these into Xendy in a moment.

Note: without read_all_orders, Shopify only provides orders from the last 60 days. If you enable this scope later, reinstall the app and reconnect. Xendy will then import the full order history.

Connect Shopify in Xendy

Via the Xendy app

  1. Install the Xendy app in your Shopify store. If you can't find the app in the Shopify App Store, request an installation link via support@xendy.me.
  2. Working with multiple Xendy accounts? In Xendy, first open the account you want to connect the store to. The store will be connected to the account you're currently working in.
  3. Open the Xendy app in your Shopify admin and click Connect to Xendy. A new tab will open.
  4. Log in to Xendy or create an account. You'll see the message "Your Shopify store [name] has been connected. The first import has started."

In the Xendy app in Shopify, you'll then see your account and the last sync under Connected Xendy accounts. The page updates itself, so you don't need to refresh. Use Connect another Xendy account to connect the same store to an additional account, for example for a different country.

The connection link is valid for 15 minutes and can only be used once. If you see a message that the link has expired or has already been used, click Connect to Xendy again in the Xendy app.

With a custom app from the Dev Dashboard

  1. First create the app (see Creating an access token in Shopify (one-time)).
  2. In Xendy, go to Settings → Web store and select Shopify under Choose your platform.
  3. Enter your Shopify domain (store.myshopify.com, not your own domain name) and paste in the Client ID and the Client Secret.
  4. Click Connect Shopify. Xendy verifies the details, connects the store, and starts the first import.

Already have a connection with a custom app or an old Admin API token? That will keep working just fine. If you switch to the Xendy app, the new connection will take over your existing data and history.

Abandoned shopping carts

Abandoned carts only work when you connect via the Xendy app. Shopify then reports an abandoned checkout directly to Xendy; you don't need to place any script.

  1. Turn off Shopify's own reminder, otherwise customers will receive two emails. You do this in your Shopify admin under Apps → Messaging → Automations → Abandoned checkout.
  2. In Xendy, go to Settings → Web store and in the Abandoned carts section, choose who receives an abandoned cart reminder. By default, only customers who gave consent for marketing. Enable Also customers without marketing consent if you want to send a reminder to others as well; guests will then also be added as a contact.
  3. Create an automation with a segment for abandoned carts (see Set up abandoned cart email automation). The button in the email brings the customer back to their checkout.

Shopify only reports a checkout once the customer has entered their email address. If the customer completes the order, the cart expires and they will not receive a reminder.

How often is data fetched?

Via the Xendy app, Shopify forwards new and updated customers, orders, and products directly to Xendy. In addition, Xendy checks every night to see if anything was missed.

With a custom app from the Dev Dashboard, Xendy retrieves your data once per day during the night.

In both cases, Xendy performs a full import once every 30 days. Don't want to wait? Go to Settings → Web store, click the three dots next to your connection, and select Sync now. Via the Xendy app, you can also do this in Shopify with Sync now.

Unsubscribes (via the Xendy app only)

  • If a customer unsubscribes from email marketing in Shopify, Xendy will also unsubscribe the contact.
  • If someone unsubscribes in Xendy (via the unsubscribe link or a complaint), Xendy will also update this in Shopify. Xendy does not pass on bounces.
  • If the customer subscribes again in Shopify at a later time, the contact in Xendy will only become active again if the unsubscribe originated from Shopify.

With a custom app, unsubscribes are not exchanged. The marketing status from Shopify will still appear on the contact, in the email_marketing_state field.

Frequently asked questions

Yes, with Shopify data you can create dynamic segments in Xendy. You can filter on:

  • Number of purchases
  • Total order value
  • How long ago someone last placed an order
  • Specific products or product categories that have or haven't been purchased

Shopify tags and the marketing status are also included as contact fields (tags and email_marketing_state, with values like SUBSCRIBED), so you can filter on those as well. This makes it easy to target campaigns at, for example, recent buyers, loyal customers with a high order value, or customers who haven't been active for a while.

If you get an error message when connecting with a custom app, go through these points:

  • Is the app installed on your store?
  • Are the app and your store in the same Shopify organization?
  • Does the app have access to protected customer data? This is not possible on a Shopify Basic or Starter plan.
  • Are the values in the correct field? A Client ID consists of 32 characters. A value starting with shpss_ is the Client Secret. A value starting with shpat_ is an Admin API token and not a Client Secret.
  • Did you enter the Shopify domain (store.myshopify.com) and not your own domain name?

If the app is missing permissions, enable read access for Customers, Orders and Products and reinstall the app.

Joeri Ras

Written by

Joeri Ras

Founder & co-owner @ Xendy

Prefer to talk directly?

Related articles