> ## 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 Integration

> Connect your Medusa store to WISEPIM. Create an admin API token, add it in WISEPIM, and start syncing your catalog.

Connect your Medusa store to WISEPIM to manage your whole catalog from one place. Medusa is an open-source headless commerce platform. Once connected, you can import products, enrich them with AI, and push the improved content back to Medusa.

Setup takes two steps: create an admin API token in Medusa, then add it in WISEPIM.

<Info>
  You need admin access to your Medusa backend and a WISEPIM account with an active project. WISEPIM connects through the Medusa Admin API.
</Info>

## Create an API token in Medusa

<img className="block dark:hidden" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=d33d3215866b79d33921ff7073381622" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp" />

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=4aae9e281b64e5bdc57a9eb4bf8456c9" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp" />

Medusa issues an API token for an admin user with access to your catalog.

<Steps>
  <Step title="Open your Medusa admin">
    Log in to your Medusa admin dashboard with an account that can manage products.
  </Step>

  <Step title="Create an API key token">
    Open **Settings** > **API Key Management** and create a new **Secret** (admin) API key named WISEPIM.
  </Step>

  <Step title="Copy the token">
    Copy the generated token now. It is only shown once.
  </Step>

  <Step title="Note your store URL">
    Your store URL is the address of your Medusa backend, for example `https://your-store.medusajs.com`.
  </Step>
</Steps>

## Add your credentials to WISEPIM

Enter the values from Medusa to finish the connection.

<Steps>
  <Step title="Open Integrations">
    Log in to WISEPIM and go to **Settings** > **Integrations**.
  </Step>

  <Step title="Select Medusa">
    Find and click the **Medusa** integration tile.
  </Step>

  <Step title="Enter your credentials">
    Fill in the following fields:

    * **Medusa URL**: your Medusa backend URL, including `https://` (for example, `https://your-store.medusajs.com`)
    * **API Token**: the admin token you created in Medusa
  </Step>

  <Step title="Test the connection">
    Click **Test Connection** to confirm your credentials work.
  </Step>

  <Step title="Save">
    If the test succeeds, click **Save**.
  </Step>
</Steps>

<Check>
  Your Medusa store is now connected. You can start importing products.
</Check>

<Warning>
  Your API token gives full access to your catalog through the Admin API. Never share it publicly or commit it to version control. If you think it is exposed, revoke it in Medusa and create a new one.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection test fails">
    Check your Medusa URL first. It must be correct and start with `https://`, and point at your backend (not the storefront). Then confirm you copied the API token exactly, with no extra spaces.
  </Accordion>

  <Accordion title="Authentication is rejected">
    Make sure you created a **Secret** (admin) API key, not a publishable key. Publishable keys cannot read or write the full catalog.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Import products" icon="download" href="/en/essentials/importing-products">
    Pull your catalog from Medusa into WISEPIM.
  </Card>

  <Card title="Enrich products" icon="sparkles" href="/en/essentials/enriching-products">
    Improve titles, descriptions, and SEO with AI.
  </Card>

  <Card title="Export products" icon="upload" href="/en/essentials/exporting-products">
    Push the improved content back to Medusa.
  </Card>

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