Brand Guide
How can we help?

What is the Shopify integration and what scopes are required?

The Shopify integration is a custom app that connects a brand’s Shopify store to ShopMy. To set up the integration, brands create a private app within their Shopify admin and authorize a set of required scopes. These scopes enable key ShopMy features like discount syncing, order tracking, and catalog access.

Required Scopes

These are automatically included when a brand sets up the Shopify integration:

  1. read_discounts, write_discounts – Enables creation and syncing of discount codes.
  1. read_price_rules, write_price_rules – Required for creating automatic discount rules tied to specific code conditions.
  1. write_orders – Used to create Lookbook orders.
  1. read_orders – Enables order tracking for both Lookbook fulfillment and affiliate sales.
  1. read_products – Allows ShopMy to sync your product catalog.
  1. read_inventory – Allows filtering by inventory location during product selection.

Optional Scopes

These additional scopes are not required but unlock advanced functionality:

  1. read_customers – Enables visibility into new vs. returning customers and supports differentiated commission rates.
  1. write_draft_orders, read_draft_orders, write_customers – Required if you’d like ShopMy to create and complete draft orders (e.g. for gifting), especially when integrating with Shopify Flow.
  1. read_locations – Needed if you are using read_inventory to pull from specific fulfillment locations.

Any brand that completes the Shopify integration will have the required scopes in place, with the option to add the others as needed based on program goals.

Did this answer your question?
😞
😐
🤩