Magento 1 & 2 Integration Guide

Integrate your Magento store with Helm to automate order syncing, maintain accurate stock levels, and unify your multi-channel fulfilment operations - all from a single dashboard.

What is Magento

Magento (also known as Adobe Commerce) is a powerful, flexible eCommerce platform used by medium to enterprise-level retailers worldwide. It supports complex catalogues, multi-site capabilities, and highly customisable storefronts

Connecting Magento to Helm ensures seamless syncing of orders and stock, empowering you to streamline your back-office operations and scale with confidence

Magento 1 and Magento 2 have different API architectures, and this distinction is crucial if you're planning to integrate or migrate systems

If You're Migrating or Building an Integration

  • Do not reuse M1 API integrations for M2 – they are not compatible

  • For new builds, Magento 2’s REST or GraphQL API is strongly preferred

  • When planning integrations with ERPs, CRMs, PIMs, etc., Magento 2 is more future-proof

Key Differences Summary

Feature

Magento 1 API

Magento 2 API

Architecture

SOAP/XML-RPC

REST, SOAP, GraphQL

REST Support

Partial

Full (including async bulk APIs)

Authentication

API keys

OAuth, Token-based (JWT)

Speed & Performance

Slower

Faster, scalable

Extensibility

Limited

Designed for extension via Service Contracts

GraphQL

❌

✅ (since Magento 2.3)

Versioning & Upgrades

Hard to maintain

Backward-compatible via contracts

PROS ✅

CONS ❌

Highly customisable and scalable for growing businesses

Requires setup of an integration user and API access via Magento admin panel

Real-time syncing of orders and inventory with Helm

May require developer involvement depending on your Magento version or setup

Supports multi-store, multi-language, and multi-currency configurations

Some plugins or custom code may affect data flow

Step-by-Step Setup

To integrate Magento with Helm:

  1. Log in to Your Magento Admin Panel
    Ensure you have administrator-level access.

  2. Create a New Integration
    Navigate to System → Extensions → Integrations
    Click Add New Integration and enter a name such as Helm Integration.

  3. Enter API Details and Permissions
    Under the API tab:

    • Grant Read/Write access to:

      • Orders

      • Products

      • Inventory

      • Shipments

    • Save and Activate the integration

  4. Copy the Access Credentials
    Once approved, Magento will display these

    • Magenta 1:

      • Domain

      • API Username

      • API Key

    • Magenta 2:

      • Domain

      • Username

      • Password

  5. Log in to Helm
    Go to Settings → My Store in your Helm dashboard.

  6. Add New Sales Channel
    Click Add New Sales Channel, then choose Magento from the list.

  7. Enter Connection Details

FIELD

DESCRIPTION

Sales Channel Name

e.g., Magento UK Store

Sales Channel Logo

Upload your Magento or store logo

Domain

The Base URL of your Magento store (e.g. https://shop.yourdomain.com)

API Username / Username

Get this from Magento 1 or Magento 2

API Key / Password

Get this from Magento 1 or Magento 2

  1. Click Continue

Interaction Settings

Configure how Helm interacts with your Magento store:

INTERACTION SETTINGS

DESCRIPTION

Sync Inventory

Automatically import products from Magento into Helm

Sync Stock Levels

Keep stock levels in sync between Magento and Helm

Use Channel Names

Show Magento product titles on orders in Helm

Max Stock Levels

Limit the quantity of stock Helm shares with Magento

Stock Buffer

Reserve a buffer to help prevent overselling

Auto Merge Orders

Merge orders from the same customer/store address

Order Importing Type

Select the date and time Helm should begin importing Magento orders

Final Steps

  • Click Save once all settings are configured

  • Set the channel to Is Active at the top of the screen

Your Magento integration is now live - and you’re ready to Take the Helm!

Common Issues

ISSUE

SOLUTION

Invalid Token or URL

Verify your store URL and access token match what Magento generated

Orders Not Importing

Ensure the integration is active and order statuses are mapped correctly

Stock Not Syncing

Confirm SKUs match between Magento and Helm, and sync settings are enabled

Permission Denied Errors

Double-check that the integration has Read/Write access to all key resources

If you experience issues and need assistance, contact Helm Support