Skip to content
RetailPrime Staging Guide
Esc
↑↓navigate↵open⌘Jpreview
On this page

Apps and Storefront API tokens

Install an app from its own site, see what it can reach, uninstall it, and create and revoke Storefront API tokens.

In Settings, press Apps. The page says Apps installed in your store. Each one reaches only the store data you allowed when installing it. Under the list is the Storefront API tokens card.

The Apps page with No apps installed and the Storefront API tokens card with 0 tokens

Install an app

You don’t install apps from this page: Apps you install from an app’s own site appear here. An app’s own site sends you to RetailPrime to install it. The example below is a test app called Order Sync by Example Apps Ltd.

  1. RetailPrime shows Install Order Sync, By Example Apps Ltd. The Order Sync will be able to card lists what it asks for, in words and by name, here View products, collections and catalogs (read_products) and View orders (read_orders). About the developer gives its support email and privacy policy. At the bottom: Order Sync is made by Example Apps Ltd, not RetailPrime. You can uninstall it at any time from Settings → Apps.

    The Install Order Sync page: what it will be able to do, About the developer, Cancel and Install app

  2. Press Install app to allow it, or Cancel to go back to the app without giving it access. After Install app, you are taken back to the app’s own site.

Installed apps

The app is now listed with its Developer, the day it was Installed, and Open app, which opens the app’s site in a new tab.

The Apps page with Order Sync, Example Apps Ltd, Nov 16, 2026, and Open app

Press the app’s name to see its page: Access (what it can reach) and Details (Installed by who and when, support email and privacy policy), with Open app and Uninstall at the top.

The Order Sync page: Access with read_products and read_orders, Details, Open app and Uninstall

Uninstall an app

  1. On the app’s page, press Uninstall.

  2. A window asks Uninstall Order Sync?: Order Sync loses access to your store at once: its access token stops working and its webhooks are removed. Installing it again starts a new install.

    The Uninstall Order Sync? window with Keep and Uninstall

  3. Press Uninstall. The Apps page says Order Sync uninstalled.

    The Apps page with Order Sync uninstalled. and No apps installed

Storefront API tokens

Tokens let a headless storefront or a server read your store through the Storefront API. The card counts your tokens. Press Manage Storefront API tokens.

The page says Every token of your store, whether staff or an app created it. The Using a token card explains: Public tokens go in code that runs in a buyer’s browser or app. Private tokens stay on servers; a server acting for a buyer can send the buyer’s address in the X-RetailPrime-Buyer-IP header. and Send either kind as Authorization: Bearer followed by the token, in a POST to /api/graphql on your store’s address.

The Storefront API tokens page: Using a token, and No Storefront API tokens

Create a token

  1. Press Create token. The window says A Storefront API token reads everything the Storefront API offers. You can revoke it at any time.
  2. Fill it in:
Box What to choose Example
Title (required) What it is for, such as “Mobile app”. Without one: Enter a title. Mobile app
Kind (required) Public: For code in a buyer’s browser or app, such as a headless storefront. It is not secret. Private: For your own or an app’s server only. Keep it secret: never put it in a browser or app. Public

The Create token window with Mobile app, Public chosen, and the message Enter a title. from pressing Create token with no title

  1. Press Create token. The Token created window shows the token once: Copy the token now. It won’t be shown again. Press Copy (it says Copied) and keep the token somewhere safe.

    The Token created window with the token, Copy, Copied and I have copied this token

  2. Press I have copied this token. The page says Token Mobile app created. The list shows each token’s Title, Kind, only its last characters under Token, who created it and when.

    The token list with Stock sync server (Private) and Mobile app (Public), each with Revoke

Revoke a token

  1. Press Revoke on its row.

  2. A window asks Revoke Stock sync server?: Storefronts and servers using this token stop working at once. This cannot be undone.

    The Revoke Stock sync server? window with Keep and Revoke

  3. Press Revoke. The token is gone. Back on Apps, the card counts 1 token.

    The Apps page with the Storefront API tokens card showing 1 token

What’s next

Domains: give your store an address of your own.