Supabind

Akeneo

Seamlessly push your transformed data to Akeneo PIM, with AI-powered field mapping and payload validation before every run.

Quick Navigation

• Connect Your Akeneo Instance• Create a Sync• Map Fields to Akeneo• Validate & Preview the Payload• Save & Reuse Sync Templates• Schedule Syncs• Monitor Sync Runs

Overview

Akeneo PIM Sync is a guided, five-step wizard-Select Source, Configure Target, Map Fields, Validate & Preview, and Sync Options-sitting alongside three management tabs: Templates, Scheduled, and Monitoring.

Connect Your Akeneo Instance

Before creating a sync, add Akeneo as a connector under Data Adapters → Akeneo PIM → Configure. This opens the Configure Akeneo PIM Connector dialog.

Akeneo PIM Configuration

Configure your connection to Akeneo Product Information Management system

Connection Name *

e.g. My Akeneo PIM

PIM URL *

e.g. https://your-instance.cloud.akeneo.com

Username *

e.g. api_user

Client ID *

From your Akeneo connection settings

Client Secret *

From your Akeneo connection settings

Password *

Your Akeneo account password

Description

Optional description for this connection

Setup instructions

  1. Log in to your Akeneo PIM instance.
  2. Navigate to Connect → Connection settings (Akeneo v4+) or System → API connections (v2/v3).
  3. Click Create to add a new connection.
  4. Enter a label (e.g. "Supabind Integration") and select the flow type-Data Source if data flows into Akeneo.
  5. Copy the generated Client ID and Client Secret into the form above, along with your username and password.
  6. Click Test Connection, then Save Connector.

Create a Sync

The Create Sync tab walks you through five steps, tracked by a progress bar at the top of the page.

Setup Progress

Step 1 of 5

1. Select Source

Choose your data file

2. Configure Target

Set up Akeneo connection

3. Map Fields

Match your fields

4. Validate & Preview

Check payload structure

5. Sync Options

Configure sync behavior

Steps 1 & 2

  1. Under Select Your Data Source, choose a transformed file from your library-make sure it's already been transformed into clean, structured data.
  2. Click Continue to Target, then under Configure Akeneo Target pick the Akeneo connector to sync to.
  3. Choose a Target Entity-for example, Products, to sync your product catalog data-then click Continue to Mapping.

Your Akeneo credentials are encrypted and stored securely-only active connections appear in the Akeneo Connector list.

Map Fields to Akeneo

Map Fields connects your source data fields to the fields Akeneo expects for the selected entity.

Steps

  1. Click AI Auto-Map to have field pairs suggested automatically, or map fields manually with Add Mapping.
  2. For each mapping, choose a Source Field (or a static value), a Target Field, and an optional Transformation.
  3. Toggle Product Attribute on for fields that require a locale/scope.
  4. Enter a Static Value to override the mapped source value for that field, if needed.
  5. Click Refresh Fields if new Akeneo attributes aren't showing up, or Show API Guide for reference.

Only base fields load automatically. If Refresh Fields fails to pull your custom attributes, your Akeneo connection may need re-authentication-check the Templates tab for a connection alert.

Validate & Preview the Payload

Before any data reaches Akeneo, Validate & Preview shows exactly what will be sent, and flags anything that would stop the sync.

Steps

  1. Open Payload Preview & Validation and review the Validation Results.
  2. Resolve any items marked as an Error-for example, a missing required identifier field-since these block the sync from running.
  3. Review items marked as a Warning, such as no attributes being mapped, and decide whether to map more fields first.
  4. Click Refresh Preview after making changes to re-validate the payload.

Save & Reuse Sync Templates

Once a sync is configured, it's saved under the Templates tab for reuse.

What you'll find there

  • Each template's source file, connector, mapped field count, and usage stats, with Run, edit, and delete actions.
  • A search bar to find a template by name.

If a connector's authorization has expired, you'll see an Akeneo Connection Expired banner naming the affected connector. Click Reconnect to re-authenticate-templates using that connector won't run until it's fixed.

Schedule Syncs

The Scheduled tab automates a saved template. Server-side automation checks for due schedules every minute.

Steps

  1. Click New Schedule, pick a saved template, and set its frequency-such as Daily-along with the time and start date.
  2. Use Trigger Now to run a schedule immediately without waiting for its next run.
  3. Review each schedule's Status, Next Run, total Runs, Success/Fail count, and Health indicator.
  4. Use the Active toggle, or the edit/delete icons, to manage a schedule.

Monitor Sync Runs

The Monitoring dashboard shows every sync run-scheduled or manual-with live totals and progress.

What it shows

  • Summary counters for Total Syncs, Running, Completed, and Failed runs.
  • Per-run detail, including the sync run ID, whether it was a Manual Sync or scheduled, source and target, and a progress bar.
  • Total Data, Processed, Failed counts, and run duration for each sync.
  • View Logs and Download for full run detail, plus an Auto-refresh toggle and a manual Refresh button.

Was this article helpful?

Need More Help?

If a sync's fields aren't loading, or a scheduled run keeps failing, our support team is here to help.

Contact Support