XC Scribe Docs

Appearance

Store Connection Setup ​

Before XC AI Content Automation can import your product catalog or push generated descriptions back to your store, it needs a secure connection to your e-commerce platform. This guide walks you through connecting Shopify, WooCommerce, or Magento 2 -- including how to create the API credentials each platform requires.

Adding a Connection ​

  1. Open the Store Connections page from the sidebar.
  2. Click Add Connection.
  3. Select your platform -- Shopify, WooCommerce, or Magento 2.
  4. Fill in the required credentials for your chosen platform (see the platform-specific sections below for details on where to find them).
  5. Click Test Connection to verify that XC AI can communicate with your store. A success message confirms that the credentials are valid and the store is reachable.
  6. Click Save to store the connection.

Once saved, the connection is available for any project in your organization. You can add multiple connections if you manage more than one store.

Shopify ​

XC Scribe connects to your Shopify store using the official OAuth app install flow. No manual API keys or custom apps are needed -- just enter your store domain and authorize the connection.

Connecting Your Store ​

  1. Open the Store Connections page and click Add Connection.
  2. Select Shopify as the platform.
  3. Enter your Shopify store domain (e.g., mystore.myshopify.com).
  4. Click Connect with Shopify. You will be redirected to Shopify.
  5. On Shopify, review the requested permissions and click Install app.
  6. After authorization, you are redirected back to XC Scribe and the connection is created automatically.

That's it -- you can start importing products right away.

Permissions ​

The XC Scribe app requests the following permissions from your store:

  • Products (read & write) -- import your catalog and sync generated content back to your product listings.
  • Content (read & write) -- publish AI-generated blog posts to your Shopify blog.

Both store product management and blog publishing are handled through a single Shopify connection. The same connection appears on both the Store Connections and Blog Connections tabs.

Disconnecting ​

You can remove the connection from XC Scribe at any time by clicking Delete on the Store Connections page. If you uninstall the XC Scribe app from your Shopify admin (under Settings > Apps and sales channels), the connection is automatically deactivated on our side.

WooCommerce ​

To connect a WooCommerce store, you need your store URL, a Consumer Key, and a Consumer Secret. Here is how to generate them:

  1. Log in to your WordPress admin dashboard.
  2. Navigate to WooCommerce in the sidebar, then go to Settings and open the Advanced tab.
  3. Click the REST API sub-tab, then click Add key.
  4. Fill in the key details:
    • Description -- A label to help you identify this key later, e.g. "XC AI Content".
    • User -- Select the WordPress user account the key should be associated with. This user must have permission to manage products.
    • Permissions -- Set to Read/Write so that XC AI can both import products and sync content back.
  5. Click Generate API key.
  6. Copy the Consumer Key and the Consumer Secret. These are displayed only once, so save them before navigating away from the page.

Back in XC AI, enter the following on the Add Connection form:

  • Store URL -- Your store's full address, e.g. https://yourstore.com.
  • Consumer Key -- The key you copied in step 6.
  • Consumer Secret -- The secret you copied in step 6.

Click Test Connection to confirm everything is working, then save.

Important: Your WooCommerce store must be served over HTTPS. The WooCommerce REST API requires a secure connection, and XC AI will not connect to stores using plain HTTP.

Magento 2 ​

To connect a Magento 2 store, you need your store URL and an integration access token. There are two parts to the setup: enabling Bearer token support (a one-time global setting) and creating the integration itself.

Step 1: Enable Bearer Token Support ​

Magento 2 ships with a security setting that prevents integration access tokens from being used as Bearer tokens. This setting must be enabled before XC AI can authenticate.

  1. Log in to your Magento admin panel.
  2. Navigate to Stores > Configuration > Services > OAuth > Consumer Settings.
  3. Set "Allow OAuth Access Tokens to be used as standalone Bearer tokens" to Yes.
  4. Click Save Config.
  5. Flush the Magento cache: go to System > Cache Management and click Flush Magento Cache.

This is a one-time setting. Once enabled, all integrations in this Magento instance can use their access tokens as Bearer tokens.

Step 2: Create the Integration ​

  1. Navigate to System > Integrations.
  2. Click Add New Integration.
  3. On the Integration Info tab, enter a name for the integration -- for example, "XC AI Content".
  4. Switch to the API tab. Under Resource Access, grant access to at least:
    • Catalog > Inventory and Products -- required for importing products and syncing content.
    • Stores -- recommended, allows XC AI to detect available store views for multi-store setups.
  5. Click Save to create the integration, then click Activate on the integrations list. Confirm the activation when prompted.
  6. After activation, Magento displays a set of tokens. Copy the Access Token (also called the Bearer token). Store it somewhere safe -- you will need it in the next step.

Back in XC AI, enter the following on the Add Connection form:

  • Store URL -- Your Magento store's base URL, e.g. https://yourstore.com.
  • Access Token -- The Bearer token you copied in step 6.

Click Test Connection to confirm everything is working, then save.

Multi-Store / Multi-Website Setups ​

If your Magento instance has multiple store views (common in multi-language or multi-brand setups), XC AI will detect them automatically and show a Store View selector in the import dialog. Select the store view whose product data you want to import. This ensures API calls use the correct scope and avoids "default website not defined" errors that can occur on multi-website Magento installations.

Managing Connections ​

After you have created a connection, you can manage it from the Store Connections page at any time.

Connection Status ​

Each connection displays one of three statuses:

  • Active -- The connection is working and credentials are valid. XC AI can import products and sync content through this connection.
  • Inactive -- The connection has been saved but has not been tested yet, or it has not been used recently. Click Test Connection to verify that it is still reachable.
  • Error -- The credentials are invalid, expired, or the store is unreachable. Update the credentials and test again to resolve the issue.

Testing a Connection ​

You can click Test Connection on any saved connection at any time to verify that the credentials are still valid and the store is reachable. This is useful after rotating API keys or if you suspect a connection may have gone stale.

Editing a Connection ​

If your API credentials change -- for example, if you rotate your WooCommerce API keys or Magento token -- click Edit on the connection and update the relevant fields. Test the connection after saving to confirm the new credentials work. Shopify OAuth connections do not require manual credential updates; if you need to refresh the connection, disconnect and reconnect via OAuth.

Deleting a Connection ​

To remove a connection you no longer need, click Delete. Note that a connection that is currently in use by one or more projects cannot be deleted. You must first remove the connection from every project that references it, and then delete it from the Store Connections page.

XC AI Content Automation

© 2026 THE XTRACODE