Magento Connector

Connect to Magento stores for real-time product import

Overview

The Magento connector allows you to import products directly from a Magento store into your WooCommerce store. This enables real-time synchronization of product data, including prices, inventory, descriptions, images, and attributes.

The connector uses Magento's REST API (v1) to fetch product data. You'll need to create an integration in your Magento admin and obtain an access token.

Prerequisites

  • A Magento 2.x store with admin access
  • Ability to create integrations in Magento Admin
  • PrimeLink installed and activated on your WooCommerce store

Setting Up Magento Credentials

Step 1: Create an Integration in Magento

  1. Log in to your Magento admin panel
  2. Navigate to System → Integrations
  3. Click Add New Integration
  4. Fill in the integration details:
    • Name: Enter a descriptive name (e.g., "PrimeLink Import")
    • Email: Enter your email address

Step 2: Configure API Permissions

After creating the integration, configure its API permissions:

  1. Click on the API tab
  2. Expand Resource Access
  3. Select the following permissions:
    • Catalog: Required to fetch product data
    • Inventory: Required to fetch inventory levels
    • Stores: Optional, for store configuration
  4. Click Save

Step 3: Activate the Integration

  1. After saving, click Activate
  2. Magento will generate access credentials
  3. Copy the Access Token immediately
⚠️ Important: The Access Token is only shown once during activation. Make sure to copy it immediately and store it securely. If you lose it, you'll need to regenerate the integration.

Step 4: Get Your Magento Base URL

Your Magento base URL is your store's URL:

  • Example: https://your-store.com
  • Do not include trailing slashes
  • Use the full URL with protocol (https://)

Configuring PrimeLink

Step 1: Start a New Import

  1. Navigate to PrimeLink → Imports → New Import
  2. Select the import type (e.g., Products)
  3. Click Next to proceed to Step 2

Step 2: Select Platform Source

  1. In Step 2, select Import from Platform (Real-time)
  2. Choose Magento from the platform dropdown

Step 3: Enter Credentials

Fill in the Magento connection form:

Required Fields

  • Magento Base URL: Your Magento store URL (e.g., https://your-store.com)
  • Access Token: The access token from your Magento integration

Step 4: Test Connection

  1. Click the Test Connection button
  2. PrimeLink will attempt to connect to your Magento store
  3. If successful, you'll see a confirmation message
  4. If it fails, verify your credentials and base URL

Step 5: Continue with Import

After a successful connection test:

  1. Click Next to proceed
  2. PrimeLink will fetch products from Magento
  3. Continue with the rest of the import wizard (mapping, options, etc.)

How Magento Import Works

Product Fetching

PrimeLink uses Magento's REST API (v1) to fetch products:

  • Products are fetched in batches using pagination
  • Uses searchCriteria for filtering and pagination
  • Fetches all product attributes, images, and inventory data

Data Mapping

Magento product data is automatically mapped to WooCommerce fields:

  • Title: Product name
  • Description: Product description (HTML)
  • Price: Product price
  • SKU: Product SKU
  • Inventory: Stock quantity and status
  • Images: Product images from media gallery
  • Attributes: Product attributes and custom fields

Incremental Updates

For scheduled imports, PrimeLink tracks the last imported page and only fetches new or updated products, making subsequent imports faster.

Troubleshooting

Connection Failed

  • Verify base URL is correct (no trailing slash, includes https://)
  • Check that the access token is correct (no extra spaces)
  • Ensure the integration is activated in Magento
  • Verify API permissions are set correctly

401 Unauthorized Error

  • Check that the access token is valid and not expired
  • Verify the integration is still active in Magento
  • Ensure the integration has the required API permissions

No Products Returned

  • Verify products exist in your Magento store
  • Check that products are enabled (not disabled)
  • Ensure the API has permission to read catalog products

Rate Limit Errors

  • Magento may have rate limits configured
  • PrimeLink automatically handles rate limiting with delays
  • For large imports, consider scheduling them during off-peak hours

Best Practices

  • Use dedicated integrations: Create separate integrations for different purposes
  • Minimal permissions: Only grant the permissions you need
  • Secure credentials: Store access tokens securely, never share them publicly
  • Test first: Always test the connection before running a full import
  • Schedule imports: Use scheduling for regular synchronization
  • Monitor rate limits: Be aware of Magento's API rate limits for large stores

Next Steps

📥 Creating Imports

Learn the complete import process with field mapping

Learn More →
⏰ Scheduling

Set up automatic recurring imports from Magento

Learn More →