# HYROS Installation: Magento

---

## STEP 1: Create the Integration inside Magento

**If automating:**
In Magento admin, create a new integration with blank callback URL and Identity link URL.

**If guiding user:**
1. "Log in to your Magento admin"
2. "Go to System → Integrations"
3. "Click Add New Integration"
4. "Leave the Callback URL and Identity Link URL blank"
5. "Save the integration"

→ Confirm: "Have you created the integration in Magento?"

---

## STEP 2: Adjust API Settings

**If automating:**
In the integration settings, click API and enable the required resources.

**If guiding user:**
1. "In the integration you just created, click API"
2. "Enable the following resources:"
   - Sales
   - Customers
   - Products
3. "Save your API settings"

→ Confirm: "Are the API permissions configured?"

---

## STEP 3: Create Integration Inside HYROS

**If automating:**
In HYROS Settings → Integrations → Magento, create the integration using your store URL and access token.

**If guiding user:**
1. "Copy your Magento store URL and access token"
2. "In HYROS, go to Settings → Integrations"
3. "Find Magento and click Configure"
4. "Create the integration with your credentials"
5. "Copy the webhook URL - you'll need this"

→ Confirm: "Is the HYROS integration created?"

---

## STEP 4: Install Webhook Extension

Magento does not support webhooks natively. You need to install an extension.

**Option A - Paid Version:**
Install from: https://www.mageplaza.com/magento-2-webhook/

**Option B - Free Version:**
Install from: https://github.com/mageplaza/magento-2-webhook

**If guiding user:**
1. "Choose either the paid or free webhook extension"
2. "Install it following Magento's extension installation guide"
3. "Configure the webhook to use the URL from HYROS"

→ Confirm: "Is the webhook extension installed and configured?"

---

## Source
Synced from: docsContent.ts (magentoGuide)
Last synced: 2026-01-03