Skip the manual navigation

Develop a custom app: API access tokens, scopes, and webhooks

Create a custom app for your own integration (a WMS, ERP, or other system), choose exactly the data it can read or write, and subscribe it to webhooks.

10 min read · Updated October 2, 2026 · Screenshots use demonstration accounts

On this page
  1. 1. Open Develop apps
  2. 2. Create an app
  3. 3. Install it to get a token
  4. 4. Scope it tightly
  5. 5. Use the dedicated POS preset if that's the goal
  6. 6. Review and revoke tokens
  7. 7. Subscribe to webhooks
  8. Completion checklist
  9. Troubleshooting
Before you start

You need store owner access, or staff with the "Manage and install apps" permission.

On a phone? Open the admin menu to find the same section. Screenshots below show the desktop view; tap “Open full size” for a closer look.
STEP 1

Open Develop apps

Go to Settings → Apps and sales channels → Develop apps.

STEP 2

Create an app

Click Create an app, enter an App name (for example "Warehouse sync"), and tick the Scopes it needs. Scopes are grouped by resource (products, orders, customers, inventory, fulfillments, discounts, locations and more), each with a Read and Write option; Read products and Read orders are ticked to start with. Click Create app.

STEP 3

Install it to get a token

The new app appears as a card. Click Install (new token) on it to get an Admin API access token. The token is shown once, in the "Copy your Admin API access token now" card, so copy it straight into your integration's configuration.

STEP 4

Scope it tightly

Grant only the scopes the integration needs, for example Read products and Read orders for a reporting tool, adding Write inventory only if it must change stock. Read orders covers the last 60 days; tick Read all orders only if the integration needs older orders. Scopes can't be changed after the app is created, so create a new app if you need different ones.

STEP 5

Use the dedicated POS preset if that's the goal

To connect your own in-store POS software, use the Connect a POS system card at the top of the page instead. It creates an app with the right access for a POS and shows its token straight away (see guide-connect-local-pos).

STEP 6

Review and revoke tokens

Each app's card lists its tokens with their Scopes, Last used date and Status. Click Revoke on a token that may be compromised or is no longer used, and Install (new token) for a fresh one. Uninstall stops every token of the app immediately.

STEP 7

Subscribe to webhooks

Go to Settings → Notifications and, in the Webhooks section, add a webhook so Lulu sends event payloads (for example orders/create, products/update or inventory_levels/update) to your integration's https:// endpoint instead of it polling the API. See "Staff order alerts and webhooks" for the full flow.

CHECK YOUR WORK

You’re ready when…

    IF SOMETHING DOESN’T LOOK RIGHT

    Troubleshooting

    I lost the access token.

    It can't be shown again. Click Install (new token) on the app's card for a new one, then Revoke the old token.

    My integration gets 403 errors on some calls.

    The token doesn't have the scope that call needs. Compare the app's scopes (shown on its card) with the call. Because scopes can't be edited, create a new app with the extra scope and install it for a new token.

    I can't see the Create an app button.

    Developing apps is available to the store owner and to staff with the "Manage and install apps" permission.

    In this section: App Store

    Still need help?

    Tell us your store address and what you’re trying to do. Leave out passwords and payment details.

    Contact support