Skip to main content
Setting up the Asana integration

Setting up the Knak<>Asana integration is easy. It allows you to set up a link between a task in Asana and an asset within Knak.

Felix Higgs avatar
Written by Felix Higgs
Updated over a week ago

Note: We recommend creating a Knak API admin user in Asana then using the API Key of that user to set up this integration. Ensure that this user has the necessary permissions to view and edit projects and tasks. More information on that can be found below.

Create a new authorized app in Asana

  1. Sign into Asana and click on the top right where your profile picture is

  2. Open Settings

  3. On the Settings modal, click on the Apps tab

  4. Under Build New Apps, click View developer console

  5. A new page will open up and allow you to manage apps and API keys

  6. Under Personal Access Tokens, click on Create new token

  7. Name the token ‘Knak Integration’ then click Create token

  8. After creating the token, copy the token string

  9. 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

  1. Log in to your Knak account

  2. Click on "Studio" on the top left corner, then click on the "Admin" button to navigate into the Admin Settings

  3. Select the "Integrations" option on the left-hand side menu bar, and then click on "Platforms"

  4. Scroll down to the Project Management section and select the Asana tile

  5. On the Asana integration tile, name your integration and paste the token string that you copied from Asana into the API Key section

  6. 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

Did this answer your question?