Generate the admin token

In a production environment, you would typically create an integration and use OAuth to provide authentication for any REST call that requires admin privileges. This process allows Adobe Commerce to verify that the caller is authorized to access the affected system resource.

In this tutorial, we will supply an admin token instead. To get a token, you must have 2FA configured. This tutorial assumes that you are using Google Authenticator as your 2FA solution. The endpoint and payload will be different for other 2FA solutions. See Two-Factor Authentication for more information.

Your request must specify the admin user's username, password and otp (one time password). The otp value is the six-digit authorization code that Google Authenticator generates.

By default, an admin token is valid for 4 hours. To change this value, log in to Admin and go to Stores > Settings > Configuration > Services > OAuth > Access Token Expiration > Admin Token Lifetime (hours).

See Token-based authentication for more information about authorization tokens.

Endpoint:

POST <host>/rest/<store_code>/V1/tfa/provider/google/authenticate

Headers:

Content-Type application/json

Payload:

{
  "username": "admin",
  "password": "<admin-password>",
  "otp": "<otp-value>"
}
Copied to your clipboard
{
  "username": "admin",
  "password": "<admin-password>",
  "otp": "<otp-value>"
}