Tutorials & Solutions
Orders management
Inventory and shipping
Payments
Catalog
Prices
Rates & Benefits
Insights
Master Data
Message Center
Sales Policies
CMS
Portal
Suggestions
Sellers
Integrations
Apps
Authentications
Account management
Billing
Credit Control
Omnichannel
VTEX IO
Projects & Integrations
Infrastructure

Creating appKeys and appTokens to authenticate integrations

Breno Barreto
Breno Barreto
Last updated
3/27/2019

Every VTEX API integration needs to authenticate through appKey and appToken.

Only the Master user of the store has permission to deal with tokens. The Master user is the one whose email is in the Contact section of the Accounts screen, in Account management.

To create these keys, follow these steps:

  1. In the new admin's sidebar, click on Account Management and then on Accounts.
  2. Type your account name in the Search bar and then hit the Enter button.
  3. Click on your account name. You'll be redirected to the Edit account page.
  4. In the Security section, click on Generate appKey and appToken.
  5. Enter a label for the appKey and appToken pair you're creating.
  6. Click on Generate new Tokens.
  7. The token is in the field that is shown next. For a matter of safety, it is shown only once. Copy this token and save it in a safe place.
Attention: every appKey and appToken pair, once is created, is born without link to an access profile. So, after creating it, you should link it to the correspondent access profile.

For that, follow these steps:

  1. In the Security section, inside the Accounts tab, copy the needed appKey, which is in the Application key column.
  2. Still inside the License Manager, enter the Users tab and search for the key you copied.
  3. Enter the user and link it to the profiles you want. This appKey will be able to authenticate integrations with the modules and features to which the chosen profile gives access.

After performing these procedures, authenticate to the API using x-vtex-api-appKey and x-vtex-api-appToken as follows:

  1. Use the x-vtex-api-appKey for the Application Key informed in the Account management
  2. Use x-vtex-api-appToken for the Token that was generated in Account management

In different systems, provided by others or not, usually the appKey corresponds to the user and the appToken to the passoword.

Still got questions?
Ask the community
Find solutions and share ideas in VTEX's community.
Talk to our experts
Get in touch if you have something specific to ask about the platform.
  • PT
  • ES
VTEX website