> ## 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.
# Medusa-integratie
> Koppel je Medusa-winkel aan WISEPIM. Maak een admin API-token aan, voeg die toe in WISEPIM en begin met het synchroniseren van je catalogus.
Koppel je Medusa-winkel aan WISEPIM om je hele catalogus vanaf één plek te beheren. Medusa is een open-source headless commerceplatform. Eenmaal gekoppeld, kun je producten importeren, ze verrijken met AI en de verbeterde content terugzetten naar Medusa.
De installatie bestaat uit twee stappen: maak een admin API-token aan in Medusa en voeg die daarna toe in WISEPIM.
Je hebt admintoegang tot je Medusa-backend nodig en een WISEPIM-account met een actief project. WISEPIM koppelt via de Medusa Admin API.
## Maak een API-token aan in Medusa
Medusa geeft een API-token uit voor een admin-gebruiker met toegang tot je catalogus.
Log in op je Medusa admin-dashboard met een account dat producten kan beheren.
Open **Settings** > **API Key Management** en maak een nieuwe **Secret** (admin) API key aan met de naam WISEPIM.
Kopieer de gegenereerde token nu. Hij wordt maar één keer getoond.
Je winkel-URL is het adres van je Medusa-backend, bijvoorbeeld `https://your-store.medusajs.com`.
## Voeg je referenties toe in WISEPIM
Voer de waarden uit Medusa in om de koppeling af te ronden.
Log in op WISEPIM en ga naar **Instellingen** > **Integraties**.
Zoek en klik op de **Medusa**-integratietegel.
Vul de volgende velden in:
* **Medusa URL**: de URL van je Medusa-backend, inclusief `https://` (bijvoorbeeld `https://your-store.medusajs.com`)
* **API Token**: de admin-token die je in Medusa hebt aangemaakt
Klik op **Verbinding testen** om te bevestigen dat je referenties werken.
Als de test slaagt, klik je op **Opslaan**.
Je Medusa-winkel is nu gekoppeld. Je kunt beginnen met het importeren van producten.
Je API-token geeft volledige toegang tot je catalogus via de Admin API. Deel hem nooit openbaar en sla hem niet op in versiebeheer. Denk je dat hij is gelekt? Trek hem dan in bij Medusa en maak een nieuwe aan.
## Probleemoplossing
Controleer eerst je Medusa URL. Die moet correct zijn, beginnen met `https://` en naar je backend wijzen (niet naar de storefront). Bevestig daarna dat je de API-token exact hebt gekopieerd, zonder extra spaties.
Zorg dat je een **Secret** (admin) API key hebt aangemaakt en geen publishable key. Publishable keys kunnen de volledige catalogus niet lezen of schrijven.
## Gerelateerd
Haal je catalogus uit Medusa naar WISEPIM.
Verbeter titels, beschrijvingen en SEO met AI.
Zet de verbeterde content terug naar Medusa.
Bekijk elk platform waarmee WISEPIM verbindt.