Skip to content

Install Asana integration

The Asana integration can be found here. Please install it in your environments before proceeding with the steps below.

Use your own Asana OAuth app

Truto connects Asana accounts through its own OAuth app, so this step is optional. To show your own app on the consent screen instead:

  1. Create an OAuth app in Asana and add https://api.truto.one/connect/asana/callback as its redirect URL. If you use a redirect URL on your own domain, add that URL instead.
  2. Enter the app's Client ID and Client Secret on the installed Asana integration. See Overriding OAuth credentials.

Connecting an Asana account


Important Note

The User Directory Activities API resource will only work when authentication is done using API Key. To generate a Service Account API Key follow this Asana guide.


  1. Click on Connect Account Click connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection link Get connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Asana account. Share connection link

  4. Select Asana Select Asana

  5. Choose how to connect:

    • OAuth 2.0: log in to your Asana account and allow access to Truto.
    • API Key: enter an API Key: an Asana personal access token from the Asana developer console, or a service account token (see the note above), and click Connect.
  6. You should now see a connection successful message. You can now close this tab.

  7. Go to your Truto account, and you should see the new Asana integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.