> ## 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 Teamwork with workstatus ?

**Organization Owner/Manage :**

* They can integrate Teamwork  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 Teamwork to start the integration .

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



**Step 5 :**  Enter your Teamwork domain, and API token. Once all required details are filled in, click the ‘Next’ button to integrate with Teamwork.

Instructions for obtaining your API token:
*  Login to Teamwork
*  Click on your name on the left side and select "Edit My Details."
*  In the popup, click on the "API & Mobile" option.
*  Click on "Generate API Token.
*  Copy the generated API token and save it securely.

Instructions for obtaining your Teamwork Domain:
*  Login to Teamwork
*  Click on your name on the left side and select "Settings"
*  In Settings, navigate to the "General" tab.
*  Locate the Site URL and copy the domain from there.


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




**Step 6 : ** Connect with Project

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

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



**Step 7 :** Map Teamwork project With Workstatus
* Navigate to the Project Mapping section after integration.
* Select the Teamwork 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 Teamwork will be synced into the chosen Workstatus project.
* Click on the Save button to complete the mapping.

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



**Step 8**: Map Teamwork User with Workstatus User
* Go to the User Mapping section.
* Select the Teamwork 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_aij1jh.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 Teamwork to create and manage the task.

**Step 2**: Integration direction (one-way sync)
This integration works in a one-way sync:
Tasks created in Teamwork 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 Teamwork 
Read/View → Redirected to Teamwork 
Update → Managed in Teamwork 
Delete → Managed in Teamwork 

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

**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 Teamwork and you again Connect then complete task status will match with Teamwork task status