Skip to main content
Only an Atlassian organization admin can create an organization API key.

​
Create an organization API key

Create an API key scoped to your Atlassian organization.

1

Open API keys

Go to Atlassian Administration, select your organization, then go to Organization settings > API keys.

2

Create the key

Select API keys with scopes and choose read:orgs:admin, read:directories:admin, read:groups:admin and read:workspaces:admin, or select API keys without scopes. Then select Create API key, name it StackOne and set an expiry date. Keys last no longer than a year.

3

Copy the key

Copy the generated key now. Atlassian shows it only once.

4

Copy the organization ID

Copy the ID from the address bar, admin.atlassian.com/o/<organization ID>/overview, into the Organization ID field. A key with scopes cannot look up its own organization, so it needs this field.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Organization API Key
  • Organization ID (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.