Skip to main content
Personal Access Tokens grant full access to your Asana account. Keep them secure and never share them publicly.

​
Prerequisites

Verify you have the necessary permissions before starting setup.

  • An active Asana account with appropriate permissions
  • Access to the workspace you want to connect

​
Generate a Personal Access Token

Create a personal access token to authenticate API requests.

1

Sign in to Asana

Sign in to your Asana account.

  • Click your profile avatar in the top-right corner and select Settings.
  • Navigate to the Apps tab.
  • Scroll to Build new apps and click View developer console.
  • Select Personal access tokens.
2

Create a new token

Click + Create new token to generate a new personal access token.

  • Enter a Token name (e.g., StackOne Integration).
  • Check the box I agree to the Asana API Terms.
  • Click Create token.
  • Copy the token immediately and store it securely for use later — it is displayed only once.

​
Find your Workspace ID

Your Workspace ID identifies which Asana workspace to connect.

  • Check your browser address bar when signed in to Asana.
  • Format: https://app.asana.com/0/{workspace_id}/...
  • Example: if your URL is https://app.asana.com/0/1201234567890123/home, your Workspace ID is 1201234567890123

​
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:
  • Access Token
  • Workspace ID
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.