Note: We recommend creating a Knak API admin user in Asana (we call ours "Knak Integration") and generating the integration API Key from that user's account. Please ensure that this user has the necessary permissions to view and edit projects and tasks.
Create a new authorized app in Asana
Click on your profile picture in the top-right corner of the screen
Open Settings
On the Settings modal, click on the Apps tab
Under Build New Apps, click View developer console
A new page will open up and allow you to manage apps and API keys
Under Personal Access Tokens, click on Create new token
Name the token ‘Knak Integration’ then click Create token
After creating the token, copy the token string
Securely save the token as you will not be able to see the full token again in Asana
Setting Up an Asana integration in Knak
Log in to your Knak account
Click on "Studio" on the top left corner, then click on the "Admin" button to navigate into the Admin Settings
Select the "Integrations" option on the left-hand side menu bar, and then click on "Platforms"
Scroll down to the Project Management section and select the Asana tile
On the Asana integration tile, name your integration and paste the token string that you copied from Asana into the API Key section
Click Save to save the integration
You are now all set to use Asana alongside Knak! To get started, go to any Knak asset and click on the Info tab. Then, paste the link to your Asana task on the right-hand side under Project Management.
Managing your integration
Now that your integration is set up, you can view its configuration, edit it, or delete it from the "My Platform Connection" list on the Integrations page.
If you need to connect a new integration – or re-add a previously deleted one – you can do so by scrolling down to the "All Platforms" section and clicking Connect or Add Another Connection on the relevant platform tile.
Mapping to Asana custom fields
It is possible to allow additional information from Asana to flow into Knak as fields which will appear on the asset Info tab in Knak.
To set this up, you will need to reach out to your Knak account team and request the desired custom fields be created in Knak to match your Asana custom fields. For example, if you want to display the custom field Deadline in Knak, you would request a field to be created in Knak called "Deadline".
Once the custom field has been created in Knak, you can map the corresponding Asana field to it via the Asana integration page in Knak. Simply select the relevant Project where the custom field(s) live and map them to the corresponding Knak field(s).
Other options
Add Link to Knak Asset in Asana - Toggle this on to automatically generate a link in Asana that can be clicked to open the Knak asset.
Add Knak Status in Asana - Toggle this on to send the Knak asset status (draft, approved, in review etc) back to Asana.
Add Knak Comments in Asana - Toggle this on to send comments added in Knak back to Asana so they will display in the comments section.
Note: Comments added in Asana will not sync back to Knak.
Enable Live Updates - Enabling live updates makes it so that mapped fields on linked assets in Knak will always be up-to-date with any changes made to those fields in Asana. If left off, field updates can be manually triggered under the Project Management section of a linked asset. Please note that by enabling live updates, the potential increase in API usage could affect performance and associated costs in your Asana instance.
Restrict to Brands - Add brand(s) here to restrict which brands can use the Asana integration.
Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com