Magento Integration

This guide explains how to create a Magento integration manually for Semantico.

Use this flow when you want Magento to connect to Semantico by creating a new integration in Magento Admin and entering the provided callback and identity URLs yourself.

Prerequisites

Before you start, have these values ready:

• Callback URL
• Identity Link URL

Semantico should provide those two URLs.

Create the integration in Magento Admin

1. Log in to Magento Admin.
2. Go to System > Extensions > Integrations.
3. Click Add New Integration.
4. Enter a name such as Semantico.
5. If you want, fill in the other contact fields like email, but the key part is the API configuration.
6. In Callback URL, paste the Semantico callback URL.
7. In Identity Link URL, paste the Semantico identity link URL.
8. Click Save.

Add the required API scopes

After saving the integration:

1. Open the API tab for the integration.
2. Grant these scopes:
   • Catalog
   • Stores > Attributes > Product
   • Stores > Attributes > Attribute Set
3. Save the integration again.

These are the Magento Admin labels you should look for when selecting permissions.

Activate the integration

1. Return to System > Extensions > Integrations.
2. Find the Semantico integration.
3. Click Activate.
4. Approve the requested access.

Magento will then send the integration credentials through the callback flow defined by the URLs above.

What Semantico needs from these scopes

The required access is:

• Catalog: access to catalog entities such as products and categories
• Stores > Attributes > Product: access to product attributes
• Stores > Attributes > Attribute Set: access to attribute sets

Verification

After activation, confirm:

1. The integration appears as active in System > Extensions > Integrations.
2. Semantico confirms the Magento connection on its side.

Notes

• The exact callback and identity URLs are environment-specific and should be provided by Semantico.
• The permission labels above match Magento Admin labels derived from Magento ACL resources:
  • Magento_Catalog::catalog
  • Magento_Catalog::attributes_attributes
  • Magento_Catalog::sets