> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mirakl Integration

> Connect a Mirakl-powered marketplace to WISEPIM. Add your API key, pick a hierarchy, and export enriched listings that meet the marketplace requirements.

Mirakl powers the marketplaces of many large retailers. If you sell on one of them, connect it to WISEPIM to build your listings once and push them out with the right content, the right images, and the right category attributes.

<Note>
  Mirakl is an **export-only** integration. WISEPIM sends your products to the marketplace but does not read listings back. Keep WISEPIM as the place where your product data lives.
</Note>

<Info>
  The Mirakl integration is available on the **Pro plan and up**.
</Info>

## Before you start

Make sure you have:

* A WISEPIM account on the **Pro plan** or higher
* A seller account on a Mirakl-powered marketplace with API access
* Your **API key** from that marketplace
* The **marketplace URL** you connect to

## Connect Mirakl to WISEPIM

<Steps>
  <Step title="Open the Integrations page">
    In WISEPIM, go to **Integrations** and find the **Mirakl** tile.
  </Step>

  <Step title="Enter your credentials">
    Fill in your **API key** and the **marketplace URL**. Every Mirakl marketplace has its own address, so use the one for the marketplace you sell on.
  </Step>

  <Step title="Choose your default hierarchy">
    Pick the category hierarchy your products belong to. This is the branch of the marketplace's category tree WISEPIM uses when it exports.
  </Step>

  <Step title="Test and save">
    Click **Test Connection**. When it passes, click **Save**.
  </Step>
</Steps>

<Warning>
  Products attach to **leaf categories** only, meaning the lowest level of the tree with nothing under it. Pick a hierarchy that ends in real, sellable categories, not a top-level group.
</Warning>

## Let AI fill the category attributes

Every Mirakl category asks for its own set of attributes, and there can be a lot of them. WISEPIM can work these out for you from the product data you already have.

This is **on by default**. Leave it on and AI derives the attributes the chosen category requires, so you do not have to fill each one by hand for every product.

<Tip>
  Enrich your descriptions and attributes in WISEPIM first. The better your source data, the more accurate the derived category attributes are.
</Tip>

## What a listing needs

Mirakl rejects incomplete listings. Fill these fields before you export.

| Field           | Required?             |
| --------------- | --------------------- |
| **Name**        | Required              |
| **Description** | Required              |
| **Price**       | Required              |
| **SKU**         | Required              |
| **EAN**         | Required              |
| **Images**      | At least one required |
| **Brand**       | Recommended           |

<Info>
  Run a data quality check on your selection before exporting. Fixing a missing EAN or image in WISEPIM is much faster than chasing a rejection afterwards.
</Info>

## Export products to Mirakl

<Steps>
  <Step title="Select your products">
    On the **Products** page, select the products you want to list.
  </Step>

  <Step title="Export to Mirakl">
    Click **Export** and choose your Mirakl marketplace as the destination.
  </Step>

  <Step title="Review the result">
    Check the export result for products the marketplace pushed back on, then fix and export again.
  </Step>
</Steps>

### Create products that don't exist yet

Turn on the auto-create option and WISEPIM creates products on the marketplace that are not there yet, instead of only updating the ones that already exist. Leave it off if you want to update your current listings and nothing more.

## Fix rejected products

When Mirakl refuses a product, WISEPIM shows you what the marketplace said, up to **20 error lines per product**. Each line names the field and the problem, so you can go straight to it.

<AccordionGroup>
  <Accordion title="A product was rejected for a missing attribute">
    The category asks for an attribute your product does not have. Fill it on the product, or let AI derive the category attributes for you, then export again.
  </Accordion>

  <Accordion title="The category won't accept my product">
    Check that your mapping points to a leaf category. Products cannot be attached to a parent category that has categories underneath it.
  </Accordion>

  <Accordion title="Nothing exports at all">
    Check your API key and marketplace URL, then run **Test Connection**. Marketplaces issue their own keys, so a key from one Mirakl marketplace never works on another.
  </Accordion>

  <Accordion title="I see more than 20 problems on one product">
    WISEPIM shows the first 20 error lines. Fix those, export again, and any remaining errors appear on the next run.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Enrich products" icon="sparkles" href="/en/essentials/enriching-products">
    Improve titles, descriptions, and attributes with AI.
  </Card>

  <Card title="Export products" icon="upload" href="/en/essentials/exporting-products">
    Push your listings to the marketplace.
  </Card>

  <Card title="Kaufland" icon="store" href="/en/integrations/kaufland">
    Sell on Kaufland's marketplaces from the same catalog.
  </Card>

  <Card title="Supported platforms" icon="layout-grid" href="/en/integrations/supported-platforms">
    See every platform WISEPIM connects to.
  </Card>
</CardGroup>