Why do I get the "401: Unauthorized"?

401 Unauthorized

If you receive the HTTP 401 Unauthorized error response: 

{
"status":401,

"errorCode":"000",

"message":"HTTP Status Response - Unauthorized",

"errorType":"security"
}
 it means there’s something incorrect in your API authentication. 

If you are using a plugin, this typically means you need to review your API authentication  plugin settings within Adobe Commerce, Hybris (SAP), SFCC, Shopify,  Netsuite or you are missing API PCI role.

To further troubleshoot this issue, please verify the following

  • Typos: Check that you copied and pasted the API key without any spaces or new lines.
  • Saved: Make sure that you clicked the Save button at the bottom of the page after generating and copying your key, before trying to use it.
  • The API key for live and test are correct: API keys are valid within the environment they are generated on, which means you can’t use your test API key on your live environment and vice versa. Check if this is correct by looking at the API key for your web service user in the Customer Area > Authentication > API Key and compare the end values in the Customer Area and your Plugin or your integration.
  • Using the Balance platform: If making requests to a balanceplatform-api endpoint, the API key will need to be generated specifically for the Balance Platform.

View and configure your API credentials

Learn more on this topic and practice what you’ve learned.

Go to your Customer Area
Stylized illustration of a customer support representative with headset.

Do you need additional help?

Contact our support team

Send us the details of your issue by adding images or screenshots.

Submit a request