Connect guide

How to connect Lume Courier to your store

To connect Lume you need one thing: a Live API key. Your Lume account owner makes it at merchant.lumecourier.com under Integrations → Developers → Create key, picks Live and ticks every scope. It starts lc_live_ and Lume shows it once. Paste it in ShipOps under Settings → Couriers → Lume Courier.

What you need

one thing
API key In the Lume merchant portal (merchant.lumecourier.com), signed in as the account owner: Integrations → Developers → Create key. Choose Live and tick every scope. Looks like: a long code that starts lc_live_. Copy all of it, with no spaces before or after. A key starting lc_test_ is a test key and will not connect.

Where to find it in Lume Courier's portal

  1. Sign in to merchant.lumecourier.com as the account owner. Staff logins cannot make a key.
  2. Open Integrations → Developers and choose Create key.
  3. Name it ShipOps, choose Live, and tick every scope.
  4. Copy the key straight away (it starts lc_live_). Lume shows it only once.

Don't have it yet?

If you are not the account owner, ask the owner to make the key, or ask Lume support. You can send this: "Please create a Live API key with every scope for our Lume account (Integrations → Developers → Create key) and send it to me. I am connecting our store to ShipOps."

Your portal email and password will not work here. The form needs the API key.

Connecting it in ShipOps

  1. Install ShipOps from the Shopify App Store, or open it if you already have it. On your first visit ShipOps asks you to connect a courier; later, it lives under Settings → Couriers & store.
  2. Choose Lume Courier and fill in API key.
  3. Press Connect Lume Courier. ShipOps checks the details with Lume Courier before it saves them, so a typo shows up straight away, not a day later. When it works you see Saved — credentials confirmed.
  4. That's it. Your Lume Courier parcels load in the background, so there is nothing to wait for. They appear in your inbox as they arrive.

ShipOps stores your Lume Courier details encrypted and uses them only to read your own account and to do what you ask from the app: a booking, a label, a retry or return. Your rates and your contract with Lume Courier stay exactly as they are, and the COD cash still goes from Lume Courier straight to your bank.

There is nothing to pick after connecting. ShipOps starts finding your Lume parcels from your store's orders, and you can book through Lume from the order screens.

Lume is marked In testing in ShipOps while it runs on its first stores; tell us if a status looks wrong.

If Lume Courier won't connect

ShipOps says this is a test key.

The key starts lc_test_. Test keys create nothing real, so ShipOps refuses them. Make a new key in the portal and choose Live.

ShipOps says the key is missing a scope.

The key was made without every box ticked. Without the tracking scope it cannot connect; without others, some actions (booking, labels, cancel) will fail. Make a new Live key with every scope ticked and paste it again.

ShipOps says Lume did not accept my API key.

Paste it again whole, with no spaces before or after. If you pasted "Bearer" in front, that is fine; ShipOps removes it. If it still fails, the key may have been deleted in the portal; make a new one.

I cannot find Integrations → Developers in the portal.

Only the account owner sees it. Ask the owner to sign in and make the key.

Some of my Lume parcels are not showing.

ShipOps finds Lume parcels from your store's orders named "Lume Courier" or with a lumecourier.com tracking link, and from parcels you book in ShipOps. A parcel whose order has no Lume tracking number is not found until Lume writes it to the order.

My Lume parcels show up under Leopards.

That happens when your own Leopards account is connected too and the order names Leopards. Lume's Shopify app writes "Lume Courier" on the order, and those parcels go to Lume.

Connect Lume Courier now

You have what you need. Install ShipOps, paste your Lume Courier details, and your parcels start arriving in a minute. Free to start, no card.