Connection and Authentication

A green connection is the first milestone. However, what matters is that every read and write process used later works with the technical user.

Username & Password

The connector requests an admin token via /integration/admin/token. This method is the reliably verified standard in version 27.10.0.16.

OAuth Integration

Consumer Key/Secret and Access Token/Secret are available. However, the current signature generation works with static values.

Do not use OAuth in production until the signature generation has been technically corrected and successfully tested for all required processes.

Setting Up the Connection

1

Verify the URL

Enter the Magento base URL without a trailing slash; the default path is /rest/all/V1.

2

Choose the default mode

Disable Use API Integration and enter User Name and User Password.

3

Run Test Connection

Check Connection Status, timestamp, and Last Error.

4

Add a read and write test

Download initial data and then upload a harmless test record. Only then are permissions and endpoints sufficiently verified.

Typical Error Patterns

Symptom	Probable Cause	Next Step
401	User, password, or token invalid	Re-check credentials and request a new token
403	API permission missing	Check the Magento role of the technical user
404	Base URL or API path incorrect	Verify the URL and /rest/all/V1
Timeout	Network, WAF, proxy, or load	Check reachability and server logs
5xx	Magento or upstream service	Save the response in the API log

Connection green, but upload still red?

The connection test confirms token retrieval and basic reachability. Uploads may require additional ACL permissions, mandatory fields, mappings, or Magento modules. Enable Developer Logging only for the affected area and repeat exactly one test record.

Credentials are integration secrets. Do not include them in screenshots, tickets, exports, or public documentation.