Skip to main content

Asana

Asana is a web and mobile application designed to help teams organize, track, and manage their work.

Authentication Types​

Asana supports 3 authentication methods:

  • OAuth - Create your own Asana app with custom scopes. Every user connects with their Asana account.

    • Pros: Full control, per-user tracking, production-ready
    • Cons: ~2 min setup

  • Instant OAuth - Use Webrix's pre-configured Asana app for the fastest setup.

    • Pros: Fastest setup, no configuration needed
    • Cons: Limited scopes, not recommended for production

  • API Key - Use a personal access token for all users.

    • Pros: Easy setup
    • Cons: Less secure, no per-user tracking

Setting up OAuth​

  1. Go to https://app.asana.com/0/my-apps
  1. Click Create new app
  1. Enter an App name and select your workspace

  1. Accept the API terms and click Create app

  2. Go to the OAuth tab

  1. Click Add redirect URL

  2. Copy the Redirect URL from Webrix and paste it

  1. Scroll down and note the Client ID and Client secret

  1. In Webrix, paste the Client ID and Client Secret

  2. Select the scopes you need in Webrix

  3. Click Save Changes

Generating an API Key (Personal Access Token)​

  1. Go to https://app.asana.com/0/my-apps

  2. Click Create new token

  1. Enter a Description for your token

  1. Click Create token

  2. Copy the token immediately (it won't be shown again)

  1. Paste the token into Webrix