Skip to main content

2.2. Full integration Setup with Magento 2.

This guide details the process of establishing a secure, two-way connection between your Magento 2 store and Fozzels. You will generate the necessary API Tokens and configure permissions, ensuring seamless product data import and content export.

The Magento 2 integration requires creating a dedicated New Integration in the Magento admin panel to generate four essential keys: Consumer Key, Consumer Secret, Access Token, and Access Token Secret. We will also configure the required fozzels_completion_date attribute for tracking content synchronization.

Part 1: Magento 2 Setup (Creating the Integration and Tokens)​

You must create a new integration and define specific permissions within your Magento admin panel.

Step 1: Create a New Integration​

  1. Log in to your Magento admin panel.

  2. Go to System / Integrations.

  3. Click the “Add New Integration” button.

Step 2: Fill in Integration Info​

  1. Navigate to the Integration Info tab (Basic settings).

  2. Fill in the required fields: 2.1. Enter Name: Fozzels. 2.2. Enter E-mail: info@fozzels.com. 2.3. Enter your Magento admin password for confirmation.

  3. Skip optional fields (Callback URL, Identity link URL).

Step 3: Configure API Permissions (Scopes)​

  1. Click the "API" tab.

  2. In the dropdown menu, select "Custom".

  3. Tick only these checkboxes (for Read/Write access): 3.1. Catalog: Categories, Inventory, Products, Update Attributes, Edit Product Design. 3.2. Stores: Settings, All Stores. 3.3. Attributes: Product, Attribute Set.

Step 4: Save and Activate the Integration​

  1. Click the “Save” button in the top right corner.

  2. On the Integrations list page, locate the new Fozzels integration.

  3. Click the ”Activate” link.

  4. On the activation detail page, check if the correct APIs (from Step 3) have been selected, and click "Allow".

Step 5: Copy and Store the API Keys​

  1. After clicking "Allow," you will be redirected to the “Integration tokens for extensions” page.

  2. Copy and securely store all four automatically filled-in values: 2.1. Consumer Key 2.2. Consumer Secret 2.3. Access Token 2.4. Access Token Secret

  3. Click “Done”.

  4. Check or edit integration details later by pressing the “Edit” button on the Integrations page.

Part 3: Fozzels Activation and Data Sync​

Step 6: Verify API Access​

Before connecting Fozzels, make sure that your server does not block or rate-limit requests from Fozzels to the Magento REST API (/rest/) and GraphQL API (/graphql). Firewalls, WAFs and security services such as Cloudflare or Sucuri can block these requests.

What to do:​

  1. Allow the Fozzels IP addresses (IPv4 and IPv6) and the Fozzels User-Agent, and exclude them from rate limiting. All addresses and settings, including Cloudflare instructions, are listed in 2.1.1. Connection Requirements: IP Addresses, User-Agent and Firewall Settings.
  2. Forward that page to your hosting provider or server administrator.

If this is not done, you will receive a 401 (Unauthorized) error when creating the integration in Fozzels, or a 429 (Too Many Requests) error during Pull Products, and the connection or synchronization will not complete.

After confirming the changes, proceed to creating the integration in Fozzels.

Step 8: Create New Integration in Fozzels​

  1. Log in to your Fozzels account.

  2. Go to Integrations.

  3. Click “Create New Integration”.

  4. Choose "Magento" from the available options.

Step 9: Fill in Connection Details​

You will use the keys from Part 1 to connect Fozzels and initiate the data import.

  1. Name your integration clearly.

  2. Enter the URL to your Magento website.

  3. Fill in the four keys copied in Step 5 into the corresponding fields.

  4. Click “Save”.

Step 10: Activate and Synchronize Stores​

  1. Switch on the ‘Active’ toggle in the top right corner. Without this, the connection will not work.

  2. Navigate to the “Websites & Stores” tab.

  3. Click the "Pull websites and stores" button. Your websites and stores should now appear.

  4. Verify that the integration has the following statuses: Authorized: yes and REST API Connected: yes.

  5. Enable the current websites and stores using the toggle for further work.

Step 11: Pull Products and Verify​

  1. Click the “Pull Products” button to start the process of importing your product catalog.

  2. Wait for the products to load (progress will be shown in the progress bar).

  3. Go to the "Attributes" tab to configure your synchronization rules.

  4. Read more about working with product attributes and customizing data fields here.