Skip to main content
Ensure you have an Atlassian account with access to the Confluence workspace you want to connect.

​
Find your Confluence subdomain

Your subdomain identifies your Confluence instance.

  • Check your browser address bar when signed in to Confluence.
  • Format: https://{your-subdomain}.atlassian.net/wiki
  • Example: if your URL is https://acme-corp.atlassian.net/wiki, your subdomain is acme-corp

​
Create an API token

Generate an API token from your Atlassian account.

1

Sign in to Atlassian

Sign in to your Atlassian account.

  • Click your profile avatar in the upper right-hand corner and select Account settings
  • Select Security tab
  • Under API Tokens, Click Create and manage API tokens
2

Create a New API Token

Create an API token and save it.

  • Click Create API token
  • Enter a descriptive name (e.g., “StackOne Confluence Integration”)
  • Set an appropriate expiry date (maximum 1 year)
  • Click Create
  • Copy the token immediately and store securely — it is only shown once.

​
Find your email

Your username is the email address associated with your Atlassian account, visible in your profile (upper right corner).

​
Add an organization API key

Only needed for the unified IAM organization actions. They read from the Atlassian organization admin API, which uses its own key rather than the Confluence API token above.

1

Create the organization API key

Create the key in Atlassian administration under Settings, API keys. This is issued at the Atlassian organization level and requires organization admin access, so it is separate from the API token you just created.

  • Paste it into the Organization Admin API Key field in StackOne Hub.
  • Leave the field empty if you do not need List Unified Organizations or Get Unified Organization. Calling either without the key returns an error naming it; nothing else in the connector is affected.
  • Atlassian lets you create the key with scopes or without scopes (full access). If you create a scoped key, select the read:orgs:admin scope — Get Unified Organization requires it, and Atlassian’s docs specify no required scope for List Unified Organizations.

​
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:
  • API Token
  • Email
  • Subdomain
  • Organization Admin API Key (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.