Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Frequently Asked Questions
Why authentication with appkey and apptoken doesn't work?
Why authentication with appkey and apptoken doesn't work?
Published on 3/12/2019
Last update on 3/28/2023

At VTEX, authentications of APIs are handled by appKey and appToken. There are however several scenarios in which an integration could fail due to errors related to these authentication keys. The following information will help you solve some of the common appKey and appToken authentication issues:

AppKey and AppToken association

Configuring a role having different access levels on the platform is possible when accessing Roles, within the Account settings menu.

When created, no pair of appKey and appToken is linked to a role. It's necessary to link both keys to a desired role.

One of the reasons for integration errors can be a lack of association of the created keys with the role. Another possible error is the link of the appKey and appToken to a profile that, although being registered, does not have enough access to perform that specific task on the platform.

Only the Sponsor user has the necessary permission to edit the keys, meaning to create the appKey and appToken used in integrations with a store.

Mistyping

Both keys should be filled out in their respective fields, without spacing and by respecting the case sensitivity. One small error while typing can impede the well-functioning of an integration.

Check for possible errors by accessing Account Management and Users.

The appToken cannot be recovered, once it has been created and displayed to the user.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback