Honey ShelfIntegrations
Connecting Shopify
Two ways to connect: install the Honey Shelf app from Shopify, or create a custom app in your Shopify admin and paste its token.
There are two ways to connect your Shopify store. The simplest is installing the Honey Shelf app from Shopify (an install link, or the App Store once listed). The original custom-app path — creating an app in your own Shopify admin and pasting its token — also remains fully supported. Only org admins can connect or disconnect integrations.
Option A — Install from Shopify
- Open the Honey Shelf install link (or find Honey Shelf in the Shopify App Store) and approve the requested permissions.
- You land on the Honey Shelf signup page. Create your account — or sign in if you already have one.
- Your store connects automatically right after your account (and organisation) is created; the catalogue and sales import starts in the background.
Finish signing up in the SAME browser you installed from — the pending store connection is held for that browser for 24 hours. If it lapses, nothing is lost: connect again from Settings → Integrations.
App installs can read the last 60 days of order history, which is plenty for the default 30-day velocity window. Custom-app connections (Option B) can read further back for the longer windows.
Option B — Create a custom app
- In Shopify admin, go to Settings → Apps and sales channels → Develop apps, and select "Create an app". Name it "Honey Shelf".
- Open the app's Configuration tab and set the Admin API access scopes listed below, then save.
- On the API credentials tab, install the app and reveal the Admin API access token (it starts with "shpat_"). Copy it — Shopify shows it only once.
- In Honey Shelf, go to Settings → Integrations, enter your store domain (yourstore.myshopify.com) and the token, and connect.
Required scopes
| Scope | Used for |
|---|---|
| read_orders | Order history and daily sales — drives velocity and demand |
| read_products | Importing your product and variant catalogue |
| read_inventory | Reading current stock levels during reconciliation |
| write_inventory | Pushing finished-goods stock to your store when you release a shipment |
| read_locations | Discovering your store locations for the inventory push |
| read_reports | Optional, custom-app tokens only — backfills historical inventory snapshots for accurate velocity. Not requested when you install the Honey Shelf app from Shopify. |
The first five scopes are required. A token missing write_inventory connects successfully but every store push fails later; a token missing read_locations blocks the location setup for pushes.
What syncs, in which direction
| Data | Direction | When |
|---|---|---|
| Orders → sales history | Shopify → Honey Shelf | Near real-time via webhooks, plus a nightly reconcile of the last 7 days |
| Cancellations | Shopify → Honey Shelf | Near real-time — the sale is removed from the original order date |
| Finished-goods inventory | Honey Shelf → Shopify | When you push a shipment in Stage 6 (Release to Store) |
A sale is counted on the date the order was placed, in your organisation's timezone — matching the numbers on Shopify's own dashboard. Inventory pushes go to your primary location only; multi-location stock split is not supported yet.
Only products that are Active in Shopify are imported — drafts and archived Shopify products never enter your catalogue. If a product you imported is later unpublished in Shopify (set to draft or archived), the next sync archives it in Honey Shelf too: it stays visible under the Archived filter and nothing is deleted. Publish the product in Shopify and run a resync (Reports → Data Health → resync, or reconnect) to bring it in or bring it back. Products you created manually or by CSV import are never touched by this reconciliation.
Troubleshooting
- Invalid token at connect time: the token was mistyped, revoked, or belongs to a different store than the domain you entered. Reveal a fresh token in the custom app and reconnect.
- Pushes failing with a permissions error: the app is missing write_inventory. Add the scope in the custom app configuration, reinstall the app, and paste the NEW token (changing scopes rotates it).
- A shipment shows "push failed": open the row on Stage 6 to see the reason and use Retry. Nothing is lost — your Honey Shelf inventory is already updated; only the store push is retried.