Buildadocs
⌘K
GuidesAPI ReferenceIntegrationsChangelog

Magento Troubleshooting

**Cause:** Invalid or expired OAuth credentials.

Magento Troubleshooting

Common Issues

401 Unauthorized

Cause: Invalid or expired OAuth credentials.

Fix:

  1. Verify credentials in Settings → Integrations → Magento
  2. Check that the Magento integration hasn't been deactivated or regenerated
  3. If credentials were regenerated in Magento, update them in Builda

403 Forbidden

Cause: The Magento integration lacks required API permissions.

Fix:

  1. In Magento Admin, go to System → Integrations
  2. Edit the Builda integration
  3. Verify all required resource scopes are granted (see Requirements)
  4. Re-activate the integration if permissions were changed

Connection Timeout

Cause: Builda cannot reach your Magento instance.

Fix:

  1. Verify the Magento Base URL is correct and accessible
  2. If Magento is behind a firewall, whitelist Builda's IP addresses
  3. Ensure HTTPS is working on your Magento store

Slow Sync

Cause: Large product catalogue or Magento server performance.

Fix:

  • Syncs with 1000+ products may take several minutes — this is normal
  • Check Magento server load during sync
  • Consider syncing during off-peak hours

Missing Products

Cause: Products may be disabled, not visible, or excluded by API scope.

Fix:

  1. Verify the product is enabled and visible in Magento
  2. Check that the product belongs to a store view accessible by the API integration
  3. Run a full Refresh Products sync

Checking API Logs

Builda logs all Magento API calls. Check Sync Data → Logs for:

  • Request/response status codes
  • Timestamps and duration
  • Error messages from Magento