Connecting your Adobe Commerce (formerly Magento) store to ConvertMate enables AI-powered agents to optimize product descriptions, meta tags, categories, and content while syncing your catalog data for comprehensive analysis and automated improvements.
Before you start
Make sure you have:
- An active Adobe Commerce or Magento 2 store with products
- Administrator access to create integration credentials
- HTTPS/SSL certificate installed on your store (required for API security)
- Adobe Commerce 2.3 or later (Magento 1 is not supported)
- An active ConvertMate account
Why connect Adobe Commerce
Connecting Adobe Commerce allows ConvertMate to:
- Sync your product catalog automatically
- Optimize product titles, descriptions, and meta tags
- Improve category and collection pages
- Generate SEO-friendly content
- Track product performance across store views
- Automate content improvements
- Monitor and enhance search visibility
Connection methods
Adobe Commerce supports two authentication methods:
Bearer Token (recommended) - Simpler setup, single token for authentication OAuth 1.0a - More secure, uses Consumer Key and access tokensChoose the method that works best for your setup. Bearer Token is recommended for most users.
Method 1: Bearer Token connection
Step 1: Create admin integration token
- Log in to your Adobe Commerce admin panel
- Go to System → Extensions → Integrations
- Click Add New Integration
Step 2: Configure integration
On the integration form:
- Name: Enter "ConvertMate Integration"
- Email: Enter your admin email
- Current Password: Enter your admin password for confirmation
- Click API tab
Step 3: Select API resources
Under API tab:
- Resource Access: Select Custom
- Expand and check these resources:
- Catalog → Products (Read, Write) - Catalog → Categories (Read, Write) - Sales → Orders (Read only) - Store → Configuration (Read only)
- Click Save
Step 4: Activate integration
- Find your new integration in the list
- Click Activate in the Actions column
- Click Allow on the confirmation popup
- Adobe Commerce displays your credentials
Step 5: Copy access token
- Copy the Access Token (long string of characters)
- Keep this secure - you won't see it again
- Click Done
Step 6: Connect in ConvertMate
- Log in to your ConvertMate account
- Go to Settings → Connections
- Find Adobe Commerce in the platform list
- Click Connect
- Select Bearer Token authentication method
Step 7: Enter credentials
On the connection form:
- Store URL: Enter your complete store URL (e.g., https://yourstore.com)
- Include "https://" at the beginning - Don't include trailing slashes or /admin
- Authentication Method: Select Bearer Token
- Access Token: Paste the Access Token from Step 5
- Click Test connection
Step 8: Verify and save
- ConvertMate tests the connection to your store
- If successful, you'll see a confirmation message
- Select your Store View to sync (if you have multiple)
- Click Save connection
- ConvertMate begins syncing your catalog
Method 2: OAuth 1.0a connection
Step 1: Create integration
Follow steps 1-4 from Method 1 (Bearer Token) to create and activate the integration.
Step 2: Copy OAuth credentials
After activating, Adobe Commerce displays:
- Consumer Key
- Consumer Secret
- Access Token
- Access Token Secret
Copy all four values securely.
Step 3: Connect in ConvertMate
- Log in to your ConvertMate account
- Go to Settings → Connections
- Find Adobe Commerce in the platform list
- Click Connect
- Select OAuth 1.0a authentication method
Step 4: Enter credentials
On the connection form:
- Store URL: Enter your complete store URL
- Authentication Method: Select OAuth 1.0a
- Consumer Key: Paste from Step 2
- Consumer Secret: Paste from Step 2
- Access Token: Paste from Step 2
- Access Token Secret: Paste from Step 2
- Click Test connection
Step 5: Verify and save
- ConvertMate tests the connection
- If successful, select your Store View
- Click Save connection
- Catalog sync begins
What gets synced
ConvertMate syncs comprehensive Adobe Commerce data:
Product data
- Product names and SKUs
- Short and long descriptions
- Meta titles, meta descriptions, and meta keywords
- Configurable products and simple products
- Pricing information (all customer groups)
- Stock levels and inventory
- Product images and media gallery
- Categories and category assignments
- Product attributes
- Custom options
Category data
- Category names and hierarchy
- Category descriptions
- Meta titles and descriptions
- Category images
- Product assignments
- Category display settings
Order data (for analytics)
- Order history
- Product performance metrics
- Revenue data by store view
- Customer purchase patterns
Store configuration
- Store name and URLs
- Multiple store views
- Currency settings
- Tax configuration
Multi-store support
- All store views in your Adobe Commerce installation
- Language-specific content
- Store-specific pricing
How sync works
After the initial connection:
Automatic sync - ConvertMate syncs with Adobe Commerce every 6 hours to capture new products, updates, and orders. Manual sync - You can trigger a manual sync anytime from Settings → Connections. Store view selection - Choose which store view(s) to sync if you have multiple. Two-way sync - When you optimize content in ConvertMate and approve changes, they're pushed back to the selected store view automatically.Using agents after connection
Once Adobe Commerce is connected, you can run e-commerce optimization agents:
Available agents
Product Optimizer - Optimize product titles, descriptions, and meta tags for SEO and conversions Category Optimizer - Improve category pages and descriptions Content Generator - Create new product descriptions in bulk SEO Auditor - Identify SEO issues across your catalog Product IQ - Deep analysis of individual product performance with recommendations Browse all e-commerce agentsManaging optimized content
When agents suggest content improvements:
Review suggestions
- Go to Content Hub → Content suggestions
- View AI-generated improvements
- See side-by-side comparison with current content
- Review SEO scores and recommendations
Apply changes
- Review the suggested content
- Edit if needed to match your brand voice
- Click Apply to push changes to Adobe Commerce
- Changes sync to your selected store view within minutes
Bulk operations
Optimize multiple products at once:
- Select products in Content Hub
- Choose optimization type
- Review batch suggestions
- Apply all or individually
Troubleshooting connection issues
Integration activation failed
If integration won't activate:
- Verify you entered your current admin password correctly
- Check that your admin user has full permissions
- Ensure Web API security settings allow integrations
- Check Adobe Commerce system logs for errors
Access token invalid
If credentials aren't accepted:
- Verify you copied the complete Access Token (no spaces)
- Check that the integration is still active in Adobe Commerce
- Ensure the integration wasn't deleted or deactivated
- Try creating a new integration with fresh credentials
Connection test fails
If the connection test fails:
- Verify your Store URL is correct and includes https://
- Check that the store is accessible (not in maintenance mode)
- Ensure Web API is enabled in Adobe Commerce configuration
- Verify no firewall is blocking API requests
- Check that SSL certificate is valid
- Review Adobe Commerce API logs
Products not syncing
If products aren't appearing in ConvertMate:
- Verify products are enabled in Adobe Commerce
- Check that products are assigned to the selected store view
- Ensure products have visibility set appropriately
- Wait 30 minutes for initial sync to complete
- Try clicking Sync now in Settings → Connections
Changes not applying to Adobe Commerce
If optimized content isn't updating your store:
- Verify the integration is still active
- Check that API resources still have Write permissions
- Ensure products exist in the store view being updated
- Clear Adobe Commerce cache after updates
- Check indexers are up to date
Store views not appearing
If you don't see your store views:
- Ensure store views are active in Adobe Commerce
- Verify the integration has access to store configuration
- Check that the API user has permissions for all store views
- Try disconnecting and reconnecting
Multi-store and multi-language setup
Adobe Commerce often uses multiple store views:
Store view selection:- Connect to your Adobe Commerce installation once
- Select which store view(s) to sync
- Each store view can be managed separately in ConvertMate
- Optimize content per store view
- Maintain brand voice across languages
- Push updates to specific store views only
- Sync your primary store view first
- Test optimization on one store view before applying to all
- Use different ConvertMate workspaces for completely separate brands
Security best practices
Integration management:- Create unique integrations for each external service
- Audit active integrations regularly
- Deactivate unused integrations
- Regenerate tokens if compromised
- Limit API resource access to minimum required
- Keep Adobe Commerce updated
- Use strong admin passwords
- Enable two-factor authentication
- Regular security patches
- Monitor API access logs
- Always use HTTPS for API connections
- Use strong SSL certificates
- Keep certificates renewed
Privacy and permissions
What ConvertMate can access:- Product and category data for optimization
- Order history for performance analytics (aggregate data)
- Store configuration for proper integration
- Customer personal information (names, addresses, payment details)
- Admin passwords
- Payment gateway credentials
- Database credentials
- Extension configuration
- Product titles, descriptions, and meta tags (only when you approve changes)
- Category descriptions and meta data (with your approval)
- Only in store views you've selected for sync
- Stored encrypted in secure databases
- Never shared with third parties
- Used only for optimization and analytics
- You can disconnect anytime
Disconnecting Adobe Commerce
If you need to disconnect:
- Go to Settings → Connections
- Find Adobe Commerce in your connected platforms
- Click Disconnect
- Confirm the disconnection
- Sync stops immediately
- Historical data stays in ConvertMate
- No new changes will be pushed to Adobe Commerce
- E-commerce agents won't run
- You can reconnect anytime
- Go to System → Extensions → Integrations
- Find the ConvertMate integration
- Click Deactivate or Delete
Adobe Commerce vs Magento Open Source
Both are supported:- Adobe Commerce (formerly Magento Commerce)
- Magento Open Source (formerly Magento Community Edition)
- Magento 2.3 or later
- Web API enabled
- REST API accessible
- Magento 1 is not supported
- Adobe Commerce has additional features (B2B, advanced permissions)
- ConvertMate works with both editions
- Connection process is identical
Common questions
Do I need Adobe Commerce to use ConvertMate?No, ConvertMate supports multiple platforms. Connect whichever e-commerce platform you use.
Does this work with Magento 1?No, only Magento 2.3+ (Adobe Commerce 2.3+) is supported.
Can I connect multiple store views?Yes, select which store views to sync during connection setup.
Will this slow down my store?No, ConvertMate uses the Adobe Commerce API efficiently and doesn't impact store performance.
Can I optimize products without auto-applying changes?Yes, all changes require your approval. ConvertMate never pushes changes without review.
Does this work with Adobe Commerce Cloud?Yes, ConvertMate works with both on-premise and cloud Adobe Commerce installations.
Can I revoke access anytime?Yes, deactivate or delete the integration in Adobe Commerce to immediately revoke access.
What's next
Now that Adobe Commerce is connected:
- Optimize your first product
- Learn about product optimization
- Browse e-commerce agents
- Set up automated workflows
Need help with your Adobe Commerce connection? Use the chat widget in the bottom-right corner or email support@convertmate.io.