> ## 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 Jira with Workstatus?

# How to Integrate Jira with Workstatus?

###### Roles and Permissions:

**Organization Owner/Manage :**

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

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

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

Instructions for obtaining your API token:
* 1. Login to Jira
* 2. Atlassian Account Settings by clicking on settings icon on the Right side top
* 3. Click on "Security".
* 4. Scroll down to the Api Token section
* 5. Create Token and SAVE it carefully as it cannot be copied later

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

**Step 6 : ** Connect with Project

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

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

**Step 7 :** Map Jira project With Workstatus
* Navigate to the Project Mapping section after integration.
* Select the Jira 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 Jira 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_1voern0.png)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1wrxkw3.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 Jira to create and manage the task.

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

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

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