> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Get your Mirakl API keys

When you use the module for the first time, set up the Mirakl connection in the **Authentication** tab (API Key + Shop ID).

**Each Mirakl marketplace needs its own API key** (and often one or more **shop IDs**).

See also: [Multi-marketplace](https://doc.common-services.com/en/article/multi-marketplace-720rdi/).

## Generate / find the API key

Generate or view the API key under **My user settings** / **Personal settings** (click your account name at the top right of the Mirakl back office), **API key** tab. Click **Generate** if needed.

Keep this key secure. Do not share it publicly.

## Find the shop ID

On the Mirakl **Dashboard**, the shop ID is the identifier **below the shop name** (often 4 or 5 digits).

If several shops exist on the **same** marketplace, note each shop ID.

## Enter in the module (Authentication/Credentials tab)

![PrestaShop Mirakl API key](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/screenshot64_1wizs10.jpg)

1. Select the relevant marketplace.
2. Open **Authentication/Credentials**.
3. Enter **API Key**.
4. Enter **Shop ID**.
5. Click **Verify**, then save the configuration.

On the same tab:

* **Debug Mode** — debug traces. **Do not leave enabled in production.**
* **File Logging** — writes logs in the module `logs/` folder.

### Several shop IDs (same marketplace)

In **Shop ID**, enter IDs **separated by commas** (e.g. `7014,7015`; spaces are ignored).

* In general, the **same API Key** works for all shop IDs your user can access.
* On export / import / acceptation, select the relevant shop ID.
* For cron: one URL per shop ID (`selected-shop-id=…`) — configure **each** URL.

**Note:** Several shop IDs ≠ several marketplaces. Another marketplace = license + dedicated setup: [Multi-marketplace](https://doc.common-services.com/en/article/multi-marketplace-720rdi/) and [Mirakl store](https://store.common-services.com/en/16-mirakl).

Next: [Profiles](https://doc.common-services.com/en/article/profiles-16bb40d/), [Categories](https://doc.common-services.com/en/article/categories-1gpry2n/), [Scheduled tasks](https://doc.common-services.com/en/article/scheduled-tasks-2og48k/).