Explanation of the Decoded JWT

After you decode the JWT, the JSON request body looks similar to this example.

For multi-tenant applications, such as apps on AppExchange, the authEndpoint and apiEndpointBase show your customer’s endpoint.

JSON Element	Description
exp	The exp (expiration time) claim identifies the expiration time on or after which the token MUST NOT be accepted for processing. Contains an IntDate value in UTC.
request.claimsVersion	The version of the JWT claims structure. 1 - legacy version 2 - default version for all new apps that provides greater security.
request.rest.authEndpoint	Contains the correct request token URL for the environment or region. For example, `https://auth.exacttargetapis.com/v1/requestToken`. For multi-tenant applications, it can contain a tenant-specific endpoint. For example, `https://YOUR_CUSTOMERS_TSSD.auth.marketingcloudapis.com/v1/requestToken`
request.rest.apiEndpointBase	Contains the correct URL for the base of the REST API. For example, `https://www.exacttargetapis.com/`. For multi-tenant applications, it can contain a tenant-specific endpoint. For example, `https://YOUR_CUSTOMERS_TSSD.rest.marketingcloudapis.com/`
request.rest.refreshToken	An OAuth refresh token for getting an updated accessToken. The refreshToken is valid for up to 700 days or until it has been used. If the token expires, inform the user to log out and log back in. This process generates a new refresh token for your app. If the refreshToken was used previously, you receive a 401 Unauthorized. The refreshToken has a 5-minute revocation period after use, allowing for more attempts in case the auth service doesn't respond immediately. If your package doesn't have an API Integration component, you don't receive a refreshToken.
request.user.id	The user ID of the Marketing Cloud user.
request.user.oauthToken	(field no longer used in claims version 2) An OAuth token valid for 1 hour that can access REST Services for the user. For more information, see Get an Access Token services page.
request.user.internalOauthToken	(field no longer used in claims version 2) An OAuth token that can access the SOAP API. It is also referred to as the legacyToken.
request.user.refreshToken	(field no longer used in claims version 2) An OAuth refresh token for getting an updated oauthToken. Refresh tokens expire after 700 days or once they have been used. When the token expires, inform the user to log out and log back in. This process generates a new refresh token for your app.
request.user.expiresIn	(field no longer used in claims version 2) Length in seconds before tokens expire. Value of 1200 is equal to 20 minutes, for example.
request.user.email	The email address of the user.
request.user.culture	The culture code of the user. Timezone and Date Format Settings
request.user.timezone.longName	The friendly name of the user's timezone.
request.user.timezone.shortName	The timezone code of the user.
request.user.timezone.offset	The Greenwich Mean Time (GMT) offset.
request.user.timezone.dst	Is Daylight Savings Time (DST) applied to this timezone setting?
request.organization.id	The Marketing Cloud account ID. For agency sub-accounts, this ID is the agency client ID and must match the value for the enterprise ID. For enterprise sub-accounts, ID this is the sub-account ID and can be different from the enterprise ID.
request.organization.enterpriseId	The Marketing Cloud top-level enterprise account ID. For agency sub-accounts, use the agency client ID for the enterprise ID.
request.organization.dataContext	The data context value represents the Marketing Cloud edition of the account. The valid values are: core - Marketing Cloud Core or Advanced Edition reseller - Marketing Cloud Agency or Agency Client (Reseller Edition or Agency) tiered - Marketing Cloud Enterprise Edition (Lock & Publish or On Your Behalf) enterprise - Marketing Cloud Enterprise 2.0 Edition
request.organization.stackKey	The Marketing Cloud server instance that the account is on. Usual production values are S1, S4, S6, S7, S10, or S50. Utilized when making Email SOAP API calls to set the appropriate web service end point.
request.organization.region	The currently supported data center regions are `NA1` and `EU1`.
request.application.id	The package ID of your application. This value is in the installed package details.
request.application.customerEnvironment	Value used to distinguish production versus development environments, for example.
request.application.redirectUrl	The URL you set for the home page of your application in the installed package. This URL is where you forward the user upon successful completion of SSO through your login page.
request.application.features	Reserved for internal use
request.application.userPermissions	Reserved for internal use

Refresh Token Implementation Restrictions

Be aware of these restrictions in your implementation code when using the refreshToken to refresh the OauthToken (accessToken) that is about to expire and keep it contextualized to the logged-in user:

The App must be installed in the account that is being used to log in. If logging in via Marketing Cloud and selecting the app from the AppExchange listings, the app is installed in the correct account.
Only use the refreshToken parameter in the request body if you need a new contextualized token.
Each time you get a new accessToken, include a request to GET /platform/v1/endpoints. This request ensures that your app is calling the correct customer endpoints.
If you are using the scope parameter (retired) while requesting a new accessToken and you want to contextualize the accessToken to the logged in user, the internalOauthToken you're using MUST NOT be expired. (The expiration time is denoted in the JWT.request.user.expiresIn value, which is in seconds.)
Here is an example /requestToken request body structure to follow.

When you use this structure to receive a new accessToken, you also receive a new refreshToken. This newly provided refreshToken must be used in the subsequent call to get a new accessToken. The previous refreshToken provided in the JWT is now invalid because you’ve used it once.