This article provides instructions for connecting Asana to your Akooda organization. This connection essentially provides Akooda with access to teams’ projects in your organization and their respective tasks. With this connection, Akooda will be granted access to all public content in your organization, as well as private content to which the Akooda integration user was manually added by participants.
For more information about how Akooda helps your organization evolve and the inherent privacy and security protections in place, see Akooda Integration Principles.
Before We Begin
Before disconnecting your organization apps, check that you have proper access to the respective app:
You’re an Admin in Akooda.
You’re an Admin or a Super-Admin in your organization in Asana (see Admin roles in Asana for more detail).
How to Connect
Step 1: Add Google Workspace User
If you haven’t already, follow step 1 in the Google Workspace connector guide.
Step 2: Assign the Integration Account an Admin Role
Go into Asana’s Admin Console using your admin account.
Click "Members" and then "Invite Members".
Invite the Integration account (e.g. akooda@[YOUR_EMAIL_DOMAIN).
Choose the integration account and enter the "Edit profile settings" menu.
Grant the integration user an ‘Admin’ role. Save the changes.
NOTE: Admin privileges are required for Akooda to be able to see metadata from all teams, not just those shared with Akooda.
NOTE: It is also possible to skip steps 1 and step 2 and to authorize Akooda with any Asana user. However, in that case, only projects shared with that admin will be accessible in the Akooda platform.
Step 3: Connect Asana to Akooda
Sign in to Akooda (app.akooda.co) with your admin user.
Navigate to the “Apps” page under the Account Settings (app.akooda.co/settings/apps)
Click on the “Connect” button for Asana, which will open an app installation page.
Sign in to your Asana account with your Integration Account.
Click “Grant access” to provide consent for Akooda to view the information needed to connect to Asana.
NOTE: During the approval process you may be warned to “make sure you trust the developer app.akooda.co”. This is OK, and is only a temporary situation while Akooda is pursuing a review by Asana that will make this step irrelevant.
NOTE: The permissions granted include seeing all workspaces, and all non-private projects and tasks (or those accessible to the admin). These are required for Akooda to be able to analyze users’ interactions in Asana’s projets. Due to the way Asana’s integrations permissions works, we the permissions asked also include some write permissions. However, these will never be used.
Step 4 (optional): Invite the Akooda Integration Account to Private Teams/Projects
Many organizations use Asana such that many teams and projects are private, or accessible only with an invitation. In such a case, members with invite permissions must opt-in the relevant content to Akooda, by adding the user created in the previous step.
Head to each private team (/project) in Asana, and click the “Invite” button on the top
Add akooda@[YOUR_EMAIL_DOMAIN]
NOTE: The integration account will be shown as a member in all teams/projects, much like any other member, and can be removed at any time. Moreover, private projects and taks will be descriptively shown in Akooda only to members who can also see them in Asana.
Next Up
Processing your organization's data post the initial integration may take up to 24 hours. Once done, you will be able to see tagged Asana interactions in your Akooda organization (according to each user’s access permission).
If you run into any problems, we’re here to help. Reach out to [email protected] to get assistance for your organization.
Any Feedback?
Was this page helpful? Provide feedback on this article and ways we can improve to [email protected].