Test Connection & Diagnostics
Before you synchronize data, the connection to the Shopware Admin API should be working flawlessly. This page shows you how to check the connection and narrow down errors.
Testing the Connection
Two helpful actions are available in the Shopware Configuration:
Test Connection – retrieves a fresh token from Shopware. If a success message appears, the URL, path, and credentials are correct.
Show Password – displays the stored credentials so that you can check them.
Check the credentials
Make sure that the Website URL (for example https://shop.example.com) and the API Module Path (usually /api) are correct. A trailing slash is removed automatically.
Run the test
Click Test Connection. The connector requests a token at …/oauth/token.
Evaluate the result
If the test succeeds, a confirmation appears. If it fails, check the causes listed below and enable the Developer Log if necessary.
Common Causes of Connection Errors
"UserName or Password is incorrect"
Incorrect credentials / wrong auth mode
Check the credentials and the Integration Access toggle
No token / empty response
URL or API path incorrect
Correct the Website URL and API Module Path
Timeout
Shop not reachable / firewall
Check reachability and the outbound HTTPS connection
Certificate error
Invalid TLS certificate
Install a valid certificate in the shop
For troubleshooting, temporarily enable Enable Developer Log. You will then see the exact request URL and the server response in the API Call Log.
Checklist
Connection failing? What to check
Is Enable set in the configuration?
Are the Website URL and API Module Path correct?
Does the authentication mode match your credentials? See Authentication Methods in Detail.
Is the Shopware Admin API reachable from outside?
Does the Developer Log show a specific error message?