Before You Begin
Before you set up the integration, complete the following recommendations:
Create a dedicated Knak API administrator user in Asana. For example, Knak Integration.
Generate the Personal Access Token (API key) from this account.
Make sure this user has permission to view and edit the Asana projects and tasks that you want to connect.
💡 Tip: Use an email alias when setting up integrations (for example, youremail+api@domain.com).
This keeps all integrations tied to one dedicated account. It also prevents disruptions if a team member leaves.
Create an Asana Personal Access Token
Before you can connect Asana to Knak, you must create a Personal Access Token (PAT) in Asana.
Create the Token
Sign in to your Asana account.
Click your profile picture in the bottom left corner.
Select Settings.
Open the Apps tab.
Under Build New Apps, click View developer console.
In the Developer Console, locate Personal Access Tokens.
Click Create new token.
Enter a name such as Knak Integration.
Click Create token.
Copy the token immediately.
Store the token in a secure location.
Important: Asana only displays the full token once. You cannot view it again after closing the window.
Connect Asana in Knak
Create the Integration
Sign in to your Knak account.
Click Admin.
Select Integrations from the left navigation.
Open the Platforms tab.
Scroll to the Project Management section.
Click the Connect button on the Asana tile.
Enter a name for the integration.
Paste the Personal Access Token that you copied from Asana.
Click Authorize.
Configure the Integration
After authorization, choose the features that you want to enable.
Option | Description |
Add Link to Knak Asset in Asana | Automatically adds a link to the Knak asset on the linked Asana task. |
Use Knak Status in Asana | Syncs the Knak asset status, such as Draft, In Review, or Approved, to Asana. |
Use Knak Comments in Asana | Sends comments from Knak to the linked Asana task. Comments created in Asana do not sync back to Knak. |
Enable Live Updates | Automatically updates mapped fields in Knak whenever changes are made in Asana. |
Restrict to Brands | Limits the integration to selected Knak brands. |
Select the options that you want to enable.
Complete one of the following actions:
Click Create New Integration if you are creating the integration for the first time.
Click Save Changes if the integration has already been created and you are updating its settings.
Link an Asana Project
After you create the integration, link it to an Asana project.
Open the integration.
Use the Select an Asana Project dropdown to choose the project that you want to connect.
If your project contains custom fields, map them to the corresponding Knak fields.
Click Save Changes.
Note: Select Do not link to a project if you do not want to associate the integration with a specific Asana project. If you do not select a project, project-specific features such as custom field mapping will not be available.
Map Asana Custom Fields
You can display Asana custom fields on the Info tab of your Knak assets.
Step 1: Create Matching Fields in Knak
Contact your Knak Customer Success Manager and request matching custom fields in Knak.
For example, if your Asana project includes a custom field named Priority, request a custom field named Priority in Knak.
Step 2: Map the Fields
After the matching Knak fields have been created:
Open your Asana integration.
Select the appropriate project from the Select an Asana Project dropdown.
The project's available custom fields are loaded automatically.
Map each Asana custom field to the corresponding Knak field.
Click Save Changes.
Note: If you change the selected Asana project after creating field mappings, your existing mappings are cleared because each project can have a different set of custom fields.
Manage Your Integration
After setup, manage your integration from the Integrations page.
Navigate to Admin → Integrations → Platforms.
Under My Platform Connections, you can:
View the integration configuration
Edit the integration
Delete the integration
Add Another Integration
To add a new integration:
Scroll to the All Platforms section.
Locate the Asana tile.
Click Connect or Add Another Connection.
Need more help? Contact support via live chat using the chat bubble in the bottom right corner or email support@knak.com.