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

# Akeneo Integration

> Connect your Akeneo PIM to WISEPIM. Create a connection in Akeneo, add the credentials in WISEPIM, and sync your catalog both ways.

Connect your Akeneo PIM to WISEPIM to enrich your catalog with AI without leaving your existing setup. Once connected, you can import products from Akeneo, improve their content with AI, and push the enriched data back into Akeneo.

Setup takes two steps: create a connection in Akeneo to get your API credentials, then add those credentials in WISEPIM.

<Info>
  You need admin access to your Akeneo instance (PIM) and a WISEPIM account with an active project. WISEPIM works with the Akeneo REST API, available on Akeneo PIM 3.0 and later (Community, Growth, and Enterprise editions).
</Info>

## Create a connection in Akeneo

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

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/ZSAdspT3WbGZ9Fjw/images/marketing-screenshots/integrations/integration-configure-akeneo-dark-transparent.webp?fit=max&auto=format&n=ZSAdspT3WbGZ9Fjw&q=85&s=73fc99238901d8a2b8081aa705c0f1fa" alt="Connecting Akeneo to WISEPIM, API credentials, locale mapping and a live connection test" width="1478" height="1978" data-path="images/marketing-screenshots/integrations/integration-configure-akeneo-dark-transparent.webp" />

Akeneo generates a set of credentials when you create a new connection.

<Steps>
  <Step title="Open Connections">
    Log in to Akeneo and go to **System** > **Connections**.
  </Step>

  <Step title="Create a connection">
    Click **Create**, name it WISEPIM, and choose the **Data destination** flow type.
  </Step>

  <Step title="Copy the credentials">
    Akeneo shows a **Client ID**, **Secret**, **Username**, and **Password** for the connection. Copy all four. You need them in the next step.
  </Step>

  <Step title="Grant catalog access">
    Make sure the connection's user group has permission to read and edit products and product attributes.
  </Step>
</Steps>

## Add your credentials to WISEPIM

Enter the credentials from Akeneo to finish the connection.

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

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

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

    * **Client ID**: the connection's Client ID
    * **Client Secret**: the connection's Secret
    * **Username**: the connection's username
    * **Password**: the connection's password
    * **Akeneo URL**: your instance URL, including `https://` (for example, `https://your-instance.cloud.akeneo.com`)
  </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 Akeneo PIM is now connected. You can import products and push enriched content back.
</Check>

<Warning>
  Your connection credentials give full access to your Akeneo catalog. Never share them publicly or commit them to version control. If you think they are exposed, delete the connection in Akeneo and create a new one.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection test fails">
    Check your Akeneo URL first. It must be correct and start with `https://`. Then confirm you copied the Client ID, Secret, Username, and Password exactly, with no extra spaces.
  </Accordion>

  <Accordion title="Authentication is rejected">
    Open the connection in Akeneo and confirm its user group has read and write permission for products. Akeneo connections inherit their access from the linked user group.
  </Accordion>
</AccordionGroup>

## Related

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

  <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 the enriched content back to Akeneo.
  </Card>

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