> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.workstatus.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Integrate Asana with Workstatus?

# How to Integrate Asana with Workstatus?

###### Roles and Permissions:

**Organization Owner/Manage :**

* They can integrate Asana with Workstatus.

Please refer following link for accessing Roles and Permission : https://support.workstatus.io/en/article/workstatus-roles-and-permissions-guide-zzkoo6/

Login as Organization Owner/Manager.

**Step 1** : Navigate to settings .

**Step 2** : Click on integrations.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_bdnyvu.png)


**Step 3** : Click on Add Integrations.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1c0ruxw.png)


**Step 4 :** Click on Asana to start the integration .

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_w9izrc.png)


**Step 5 :**  Enter your Asana Personal Access Token , domain, and Workspace GID. Once all required details are filled in, click the ‘Next’ button to integrate with Jira.

Instructions for obtaining your Personal Access Token:
* 1. Login to your Asana account
* 2. Click your profile photo in the top-right corner and select "My setting".
* 3. Go to Apps tab and click 'Manage Developer Apps'
* 4. Click '+' Create a new personal access token 
* 5. Give it a name (e.g., 'Workstatus Integration') and copy the token provided.

Instructions for obtaining your Asana Workspace GID:
* 1. Login to your Asana account
* 2. Go to any project within the workspace you want to sync.
* 3. The GID is the first long number in the URL (e.g., app.asana.com/0/1201234567890/list).

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_18va1fl.png)


**Step 6 : ** Connect with Project

Click on **Connect Project** to link a project with Asana .

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_16hfepm.png)


**Step 7 :** Map Asana project With Workstatus
* Navigate to the Project Mapping section after integration.
* Select the Asana Project from the available list.
* Choose the Workstatus Project that you want to map with:
* You can select an existing project, OR
* Click on Create New Project to create a new one
* Once selected, all tasks from Asana will be synced into the chosen Workstatus project.
* Click on the Sync button to complete the mapping.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1aempql.png)


**Step 8**: Map Asana User with Workstatus User
* Go to the User Mapping section.
* Select the Asana User that you want to map.
* Choose the corresponding Workstatus User.
* Click on the Save button to complete the mapping.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_sqa7uh.png)



**Post-Integration Behaviour – Step-by-Step**
**Step 1**: Task creation Flow
After successful integration, when you try to create a task in Workstatus,
* You will be redirected to Asana to create and manage the task.

**Step 2**: Integration direction (one-way sync)
This integration works in a one-way sync:
Tasks created in Asana will automatically sync to Workstatus
Synced tasks will be visible in Workstatus

**Step 3**: Task management (CRUD operation)
All task operations are controlled externally:
Create → Managed in Asana 
Read/View → Redirected to Asana 
Update → Managed in Asana 
Delete → Managed in Asana 

** If you try to:**
View task details OR
Add/update anything from Workstatus
* You will be redirected to Asana 

**Step 4**: Behaviour after disconnection
If the integration is disconnected:
All new operations will be handled directly in Workstatus

**Step 5**: Existing task after disconnection
For tasks created during integration:
* You cannot edit or update
* You cannot delete
* You can only mark them as complete
Same task status is in progress in Asana and you again Connect then complete task status will match with Asana task status