> ## 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 GitHub in Workstatus ?

1. Open a web browser and navigate to [**https://github.com/**](https://github.com/)
2. Click on the **Sign in** option.
3. Enter your account credentials.
4. Successfully log in to access the GitHub dashboard.

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

1. Open a web browser and navigate to [**https://github.com/**](https://github.com/).
2. Click on the **Sign in** option.
3. If you do not have an existing account, create a new GitHub account by following the on-screen registration process.
4. Once the account is created, log in using your credentials to access the GitHub dashboard.

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


1. After successful sign-in, the GitHub homepage (dashboard) will be displayed.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1rebw6y.png)
1. Click on the **Profile** icon in the top-right corner of the page.
2. From the dropdown menu, select the **Your repositories** option.
3. Click on **New** to create a new repository.
4. Enter the required repository details and click **Create repository** to complete the process.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_zeeg7x.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_nbhvxc.png)
1. Verify that the repository creation process has completed successfully.
2. Confirm that the newly created repository appears under **Your Repositories** in your GitHub account.
3. Open the repository to ensure it is accessible and ready for adding files, code, or configurations.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1mwsqox.png)
1. Click on your **Profile** icon in the top-right corner of the GitHub page.
2. From the dropdown menu, select **Your organizations**.
3. Click on **New organization**.
4. Select **Create a free organization** to proceed with the organization setup.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_7vt6lu.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_cldqv1.png)](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_h8vy7m.png)
1. Fill in the required organization details and credentials.
2. Click on **Next** to continue.
3. After successful setup, the newly created organization will be visible in your account.
4. Click on the organization name to open it.

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


1. The organization homepage will be displayed.
2. Click on the **Projects** button to proceed.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1yhs194.png)
1. Click on **New Project** from the Projects section.
2. Choose any available feature or template on which you want to create the project.
3. Enter the **Project Name** in the required field.
4. Click on **Create Project** to successfully create the project.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_hcc8ai.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1iz54de.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1q8mwh2.png)](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_nkk6ou.png)
1. Select the newly created project from the list of available projects.
2. Upon selection, the project details page will be displayed, indicating that the project has been opened successfully.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1y6oapr.png)
1. Log in to your **Workstatus** account.
2. Enter the valid credentials
3. Click on login
4. Navigate to the **Settings** section.
5. Click on **Integrations** to proceed.
6. Then Click on add** Integrations.**


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

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

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

1. Select **GitHub.**

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

1. Enter the **Personal Access Token** in the designated field.
2. Enter the **Organisation Name** in the corresponding field.

To get ***Personal Access Token*** follow these steps

1. Visit GitHub account
2. click on profile image
3. click on setting
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_mw9ha6.png)

1. Scroll downward
2. There is a Developer option
3. select Developer option
4. Then select Personal Access Tokens
5. Click on Tokens(Classic)

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_tds1c9.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_14tvzk5.png)
1. Click on Generate new tokens
2. Then click on Generate new token classic.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_8tpgqc.png)
1. Enter Note
2. Select checkbox of Project
3. click on Generate Token

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


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

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

1. Copy the generated token

### How to integrate Github project

###### Step 1. GitHub integration
Go to workstatus Setting>>Integrations> > Github >> Enter Personal Access Token and Organization name or Username and click on Next button 

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


###### Step 2. Connect Project 

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

###### Step 3. Map Github Project with Workstatus Project

Select the GitHub project and the Workstatus project that you want to map with GitHub. You can also create a new project in Workstatus and map it with GitHub.

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

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

If you want to disconnect a Workstatus project from a GitHub project, click on the Disconnect button. After disconnecting, any changes made in the GitHub project will not be reflected in the Workstatus project.

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


###### Step 4. Map Github user with Workstatus user

Select the GitHub user and the Workstatus user that you want to map. Once mapped, any task assigned in the GitHub project will automatically be assigned to the mapped user in Workstatus as well.

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

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

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

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

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

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