Access tokens overview

What is an access token

The Atlassian Marketplace provides partners with access tokens that enable you to install and test Marketplace apps under development in live cloud instances. This removes the need of having licenses generated through the Atlassian billing system. Access tokens can also be used to install and manage private Marketplace apps, they are specific to installing Marketplace apps and are not to be confused with the similiarly named API token used for authentication with REST calls.

With an access token a Marketplace app can be set to various license states like valid, expired, and unlicensed.

To generate an access token:

1. Go to the Private listings page in your Marketplace app's management section.
2. Click Create a token. The token appears in the list.

How to generate and apply an access token

Access tokens can be generated from the Private Listings page in the management section of a Marketplace app. Here you select the "Create a token" button, the token will then appear in the list bellow:

To use a token on an instance that does not already have the Marketplace app installed in it;

1. Click the token link and copy the URL. The URL should look like a connect descriptor and end with ?access-token=[TOKEN_ID].
2. In the Atlassian cloud app, navigate to the Manage add-ons page and click Upload add-on
3. Paste the copied token URL into pop up screen that appears.

The installed Marketplace app with the access token looks like this:

The Access token status drop down lets you choose from a selection of license types, enabling the testing of the Marketplace app in these various states.

It's also possible to apply an access token to an already installed Marketplace app.

There are 2 ways to apply a token to a Marketplace app that has already been installed:

• Copy the token value then select the pencil icon to input it directly
• Select the + icon to go to the Marketplace app's private listing page, where an access token can be generated.

Private Marketplace apps and Private Marketplace app versions

Access tokens work for both private Marketplace app versions and public versions. If a Marketplace app has both private and public versions then the access token entry will offer links for both the latest private and public versions of the Marketplace app.