Guide

Getting started: connect Nuira to PrestaShop

Learn how to create a read-only webservice key in your PrestaShop back office and connect your store to Nuira to turn orders, revenue and product costs into prioritized growth recommendations.

Updated: 17 August 2026

Nuira helps ecommerce teams decide what to do next by combining your store’s orders and product costs with your ad spend, then surfacing the actions most likely to grow profit. This guide walks you through connecting PrestaShop to Nuira.

PrestaShop is self-hosted, so connecting it works differently from a hosted platform. There is no “install an app” flow: you create a read-only access key inside your own back office and paste it into Nuira. It takes about five minutes.

Before you start

You’ll need administrator access to your PrestaShop back office, and a Nuira workspace. If you don’t have a Nuira account yet, sign up at app.nuira.ai/signup and create a workspace before continuing.

Your shop needs to be reachable over HTTPS. Nuira will refuse to connect over plain HTTP, because your access key is sent with every request and would otherwise travel unprotected.

These steps apply to PrestaShop 1.7, 8.x and 9.x. The back-office wording differs slightly between versions, but the menus are in the same places.

Step 1: Turn on the webservice

In your PrestaShop back office, go to Advanced Parameters → Webservice.

Set Enable PrestaShop Webservice to Yes and save. It is off by default, so this step is required even if a key already exists.

Step 2: Create a key

Click Add new webservice key.

Click Generate to create a 32-character key. Use the generated value rather than typing your own — PrestaShop expects exactly 32 characters.

Give it a Key description you’ll recognise later, such as Nuira analytics (read-only), and set Status to Enabled.

Step 3: Grant View access — the step to get right

In the Permissions grid, tick View for each resource below. Leave Modify, Add and Delete unticked everywhere: Nuira only ever reads from your shop and never writes to it.

• orders
• order_details
• order_histories
• order_states
• products
• combinations
• stock_availables
• customers
• currencies
• shops
• configurations

This is the step worth double-checking. The permission grid is per-resource, so a single missed tick lets most of the sync succeed while one part fails silently. order_details is the one to be most careful with — it carries the per-item cost that every margin figure depends on, and without it Nuira can show you revenue but not profit.

If you do miss one, Nuira will tell you exactly which resource is missing when you connect, so you can come back and tick it.

Save, then copy the key.

Step 4: Connect from Nuira

In your Nuira workspace, click Integrations in the left sidebar, find the PrestaShop tile and click Connect. If it isn’t showing, open the Add integration tile and pick PrestaShop from the catalog.

Enter two things:

• Shop address — the full address of your shop, for example https://shop.example.com. If PrestaShop is installed in a subfolder, include it: https://example.com/prestashop.
• Webservice key — the key you copied in step 3.

Nuira checks every required resource before saving anything. If something is wrong you’ll get a specific message rather than a generic failure:

• The key was rejected — it’s mistyped, or its status isn’t Enabled.
• No PrestaShop API answered at that address — check the address, including the subfolder, and that URL rewriting is enabled on your server.
• The key cannot read <resource> — a View checkbox from step 3 was missed.
• We could not reach your shop — it may be down, or a firewall or security plugin may be blocking us.

Step 5: Confirm the sync

Once connected, your Integrations page shows PrestaShop with a Connected badge and syncing starts in the background.

The first sync imports roughly the last 90 days of orders, with their line items and the supplier cost recorded against each one. Nuira paces these requests deliberately rather than pulling as fast as it can — your shop runs on your own server, and a fast import would slow your storefront for real customers. A large catalogue may therefore take a while. After the first sync, Nuira refreshes every few hours and only pulls orders that changed since the last run.

A note on product costs

PrestaShop records the supplier price against each order line at the time of the order. That is genuinely useful: it means your historical margins stay accurate even after you change a product’s cost, which is not true of every platform.

If you’ve never filled in supplier or wholesale prices, Nuira will show revenue but report margin as unknown rather than assuming your costs are zero. A missing cost is obvious; a cost silently treated as zero would show a 100% margin and quietly mislead every recommendation built on it. You can add costs in PrestaShop at any time and they’ll be picked up from the next orders onward.

Disconnecting or revoking access

To stop syncing from Nuira, go to Integrations, click the ··· menu on the PrestaShop tile and choose Disconnect. This removes Nuira’s stored key and stops future syncs. Historical data already imported is kept, so your past recommendations don’t silently change.

Because the key lives in your own shop, you can also revoke access directly: go to Advanced Parameters → Webservice, and either set the key’s status to Disabled or delete it. Nuira will then report the connection as needing attention on its next sync.

Need help?

If you run into any issues connecting your store, reach out to marc@nuira.ai and we’ll help you get set up.