API keys — connect an app to your store
An API key lets an app or a service (a chatbot that takes orders, your own warehouse system, an automation tool) read and change your store through the Ordexs API. You find them in Settings → Developers → API keys.
Who can manage them. The store owner and admins. Other team members with access to settings can see the list but not create or revoke keys.
Plans. API keys come with the Starter, Growth and Scale plans: 3, 10 and 25 active keys. On Try, existing keys are paused (not deleted) and work again as soon as the store upgrades.
Creating a key. Press Create key, give it a name you'll recognise, pick Live or Test, and choose its permissions. Shortcuts are there for Read only, Orders app and Full access; you can tick individual permissions instead (see products and stock, change orders, see customers, see shipments, send to the courier, assign orders, see stock details, manage stock, see or manage offers and discounts, see cash and payouts, record courier payouts, manage webhooks, and so on). "Manage stock" lets an app add or remove stock with a reason, book deliveries in and run stock counts; its changes appear in the stock history under the key's name. "See cost prices" is off unless you turn it on.
Send to the courier. A key with this permission can send your orders to your courier and cancel parcels the courier hasn't picked up yet, exactly like the Send to courier button: same courier choice (the one picked at checkout, else your routing rules, else your default), same checks. Each send from a live key is a real parcel at your courier. Orders still waiting for their address to be checked can't be sent. A test key never reaches a courier: its parcels are simulated.
Offers and discounts. "Manage offers and discounts" lets an app create, change, pause and delete your bundles, quantity packs, cross-sells and discount codes, the same as the Offers and Discounts pages, with the same limits (30 offers, 50 discounts). "See offers and discounts" only reads them and their results, and checks whether a code works.
Changing orders already sent. An app that can change orders can also fix an order whose parcel the courier already has, like saving the order card: the change goes to the courier first and is saved only if the courier accepts it, for the details that courier lets you change, until the parcel is validated or picked up.
Bulk jobs. An app can send thousands of orders, product changes or stock changes at once (up to 10,000 lines per job). Ordexs works through them in the background, each exactly as if it were sent alone, and tells the app which lines failed and why. A store runs 3 jobs at a time. An app that can read orders can also download them all as one export file.
Marketing pixels. "Manage marketing pixels" lets an app add, change or remove your Meta, TikTok, Google and other pixels, like Integrations → Pixels. The Conversions API token is never shared with apps: you add it in the dashboard.
Store content. "Manage store content" lets an app change your store's details (name, contact, address, storefront language, timezone, order number prefix), your policies, your content pages and your order form's fields and buttons. Landing pages can be published, renamed, duplicated or deleted, but their design stays in the page builder.
Analytics. "See analytics" lets an app read the same numbers as the Overview (orders, revenue, visits, your cash, couriers, best sellers, regions), customer Insights and team performance. It can't change anything.
Delivery setup. "Manage delivery setup" lets an app change your delivery prices per wilaya, the pricing strategy (your own prices, the customer picks a courier, or the cheapest courier), door delivery and stop desk on or off, the default courier and the routing rules, like the Delivery page. Connecting a courier account (its keys) is still done in the dashboard only.
Product images. A key that can change products can also add product images: from a web address or a file the app uploads. Ordexs makes the same sizes the dashboard makes and puts the file in your Media library, where it counts toward your storage like any upload. An app can add at most 500 images a day per store, and a product holds 50 images at most.
Returns and cash. With "Manage stock", an app can mark returned parcels as arrived and check them in (back to stock or written off with a reason), like the Returns window; Ecotrack-family couriers are told the parcel came back, as they are from the dashboard. "See cash and payouts" reads what each courier owes for delivered orders and its payouts; "Record courier payouts" records the cash a courier hands over (and deletes a payout, which puts its orders back to waiting for payment), like Your cash on the Overview.
The key is shown once. After creating it, Ordexs shows the full key a single time. Copy it into your app straight away. Ordexs only keeps a fingerprint of it, so it can't show it again. If it's lost, create a new key and revoke the old one.
Live and test keys. A live key works on your real orders, products and customers. A test key works on a separate test store, so an app can be tried safely; see the test mode chunk.
Revoking. Press the revoke button on a key and confirm. Apps using it stop working within about 30 seconds. Revoking can't be undone.
What the list shows. Each key's name, whether it is live or test, how many permissions it has, when it was last used and who created it. Changes an app makes appear on orders as made by API key "<its name>".
How fast an app can go. Requests per minute depend on the plan: 120 on Starter, 300 on Growth, 900 on Scale. Test keys get 60 (120 on Scale).
Developers find everything they need at ordexs.com/docs, linked from the top of the Developers page.