How to integrate GitHub in Workstatus ?

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

1. Open a web browser and navigate to 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.

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

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.

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.

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.

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.

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

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.

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.

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.

1. Select GitHub.

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

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

1. Click on Generate new tokens
2. Then click on Generate new token classic.

1. Enter Note
2. Select checkbox of Project
3. click on Generate Token

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

Step 2. Connect Project

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.

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.

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.

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

Updated on: 11/05/2026