{"componentChunkName":"component---src-templates-help-article-template-jsx","path":"/help/articles/61000165169","result":{"data":{"allContentfulHelpCategory":{"edges":[{"node":{"categoryTitle":"Extensions","categoryId":"61000063757"}},{"node":{"categoryTitle":"With Slack","categoryId":"61000080941"}},{"node":{"categoryTitle":"Mobile app","categoryId":"61000080939"}},{"node":{"categoryTitle":"Account & billing","categoryId":"61000080940"}},{"node":{"categoryTitle":"How to guides","categoryId":"61000063760"}},{"node":{"categoryTitle":"Getting started","categoryId":"61000063758"}}]}},"pageContext":{"article":{"id":61000165169,"type":1,"status":2,"agent_id":61003830981,"created_at":"2020-03-04T01:30:32Z","category_id":61000063757,"folder_id":61000093543,"title":"Using the Bitbucket extension","updated_at":"2021-01-08T00:31:49Z","description":"

Attach your pull requests directly to tasks and see the review results with our Bitbucket extension.

How to add Bitbucket to a space


Authorizing Bitbucket

How to connect a repository

How to disconnect a repository

How to add a Bitbucket pull request to a task

Quick note - if you click on a repository with no pull requests, you'll need to use close the dialogue by clicking on the X.

Seeing the pull request results in your task


","description_text":" Attach your pull requests directly to tasks and see the review results with our Bitbucket extension. How to add Bitbucket to a space Open the space in the Workast web app where you'd like to add pull requests.  (You will need to add the bitbucket app to each space individually. Click on the app menu (plus sign, or arrow if you have more than three apps/extensions) at the top of the space  Click on \"Manage extensions\" This will open the extensions dialogue for the space.  You'll find the apps that are not added to your current space under the \"Add new extensions\" heading.  Find \"Bitbucket\" then click \"Add\" to add it to the space.   Authorizing Bitbucket The first time you use Bitbucket in Workast, you'll need to log in to your account and authorize the app. Click on the apps menu in the upper right-hand corner of your space.  Select \"Bitbucket.\"  If you see the Bitbucket icon in the top of your space, you can click that instead. A dialogue will open.  Click \"Connect Bitbucket.\" Next, the login screen will open.  Log in to your Bitbucket account.  A permission dialogue will open next.  Click \"Grant access\" to confirm.  You will then be able to connect a repository to your space.  How to connect a repository In order to attach a pull request to a task, you must first connect the repository to your team. Click on the ellipses (three dots - the apps menu) in the upper right-hand corner of your space.  Select \"Bitbucket.\" A dialogue will open.  Select \"Connect a repository\" then \"Connect repository.\" You'll then be directed to a new screen which will allow you to search your repositories. Search for the repository that you wish to connect by entering its name into the search field.  Click on it when it appears in the search results. Once you connect a repository, it will be available in the initial \"Connect a repository\" dialogue in all spaces where the Bitbucket integration has been added. How to disconnect a repository Click on the the apps menu (arrow in the upper right-hand corner of your space.  Select \"Bitbucket.\" Click on the repository that you want to disconnect. Select \"Disconnect\". Click \"Yes\" to confirm. How to add a Bitbucket pull request to a task In the Workast web app, open the task details screen by clicking on your task.   Click on the ellipses (three dots - the task menu) in the task header and select \"Attach Pull Request.\" A dialogue will open with a list of your connected repositories.  Choose the repository by clicking on it.  (If you only have one connected repository, this step may be bypassed.) Once you select a repository, you'll be presented with a list of all the available pull requests.  Only open pull requests will be listed. Click on your pull request to attach it to the task. Quick note - if you click on a repository with no pull requests, you'll need to use close the dialogue by clicking on the X. Seeing the pull request results in your task When a pull request is merged, the merge will be confirmed in your task: When a pull request is declined, it will also be confirmed in your task: ","seo_data":{"meta_title":"Using the Bitbucket integration","meta_description":""},"tags":["apps","integrations","bitbucket","developer"],"attachments":[],"cloud_files":[],"thumbs_up":0,"thumbs_down":0,"hits":11,"feedback_count":0},"folderArticles":[{"id":61000165168,"type":1,"status":2,"agent_id":61001396131,"created_at":"2020-03-04T01:30:32Z","category_id":61000063757,"folder_id":61000093543,"title":"Using the Github Integration","updated_at":"2021-01-04T23:06:15Z","description":"Attach your pull requests directly to tasks and see the review results with our Github integration.

How to add Github to a space

How to add a Github pull request to a task

Seeing the pull request results in your task

","description_text":"Attach your pull requests directly to tasks and see the review results with our Github integration. How to add Github to a space Click on the app button (square grid) in the top right-hand corner of your space. Select \"Manage apps.\" Click \"Install\" next to Github. You will then be asked to give Workast permission to access Github  Follow the prompts on your screen and click \"Authorize\" to  allow  the integration.  (If you are signed in to multiple Workast  teams, you can scroll through  your different teams by clicking on the  arrow next to the team name. ) Once your account is connected, you are able to add Github to your space. Click on the app button (square grid) in the top right-hand corner of your space again. Select \"Manage apps.\" Click on \"Add\" next to Github.  This will add Github to your space. How to add a Github pull request to a task In the Workast web app, make sure you are in the list view (not board or calendar view) then click on the task needing the pull request to maximize it.   Under \"Apps\" next to the Github icon, select \"Attach pull request.\" Click \"Connect Github\" to connect your Github account.   You can choose to either allow permission for only select repositories or for all repositories to be linked to Workast. Click \"Approve and Install\" to complete connecting your Github account. Click on \"Attach pull request\" next to the Github icon once again. Your three most recent pull requests will appear - if you want to select one of those requests, click on the pull request to attach it. If you want to add a different pull request, click on \"Browse by repository\" and use the arrow to search for the desired repository, and then click on the pull request to attach it to the task. Seeing the pull request results in your task When a pull request is merged, the merge will be confirmed in your task. When a pull request is declined, the decline will be shown in your task. ","seo_data":{"meta_title":"How to add the Github Integration to a Space","meta_description":"Add Github to a Workast Space so that you can see pull requests on a task. "},"tags":["github","extensions","apps","integrations"],"attachments":[],"cloud_files":[],"thumbs_up":0,"thumbs_down":0,"hits":11,"feedback_count":0},{"id":61000165169,"type":1,"status":2,"agent_id":61003830981,"created_at":"2020-03-04T01:30:32Z","category_id":61000063757,"folder_id":61000093543,"title":"Using the Bitbucket extension","updated_at":"2021-01-08T00:31:49Z","description":"

Attach your pull requests directly to tasks and see the review results with our Bitbucket extension.

How to add Bitbucket to a space


Authorizing Bitbucket

How to connect a repository

How to disconnect a repository

How to add a Bitbucket pull request to a task

Quick note - if you click on a repository with no pull requests, you'll need to use close the dialogue by clicking on the X.

Seeing the pull request results in your task


","description_text":" Attach your pull requests directly to tasks and see the review results with our Bitbucket extension. How to add Bitbucket to a space Open the space in the Workast web app where you'd like to add pull requests.  (You will need to add the bitbucket app to each space individually. Click on the app menu (plus sign, or arrow if you have more than three apps/extensions) at the top of the space  Click on \"Manage extensions\" This will open the extensions dialogue for the space.  You'll find the apps that are not added to your current space under the \"Add new extensions\" heading.  Find \"Bitbucket\" then click \"Add\" to add it to the space.   Authorizing Bitbucket The first time you use Bitbucket in Workast, you'll need to log in to your account and authorize the app. Click on the apps menu in the upper right-hand corner of your space.  Select \"Bitbucket.\"  If you see the Bitbucket icon in the top of your space, you can click that instead. A dialogue will open.  Click \"Connect Bitbucket.\" Next, the login screen will open.  Log in to your Bitbucket account.  A permission dialogue will open next.  Click \"Grant access\" to confirm.  You will then be able to connect a repository to your space.  How to connect a repository In order to attach a pull request to a task, you must first connect the repository to your team. Click on the ellipses (three dots - the apps menu) in the upper right-hand corner of your space.  Select \"Bitbucket.\" A dialogue will open.  Select \"Connect a repository\" then \"Connect repository.\" You'll then be directed to a new screen which will allow you to search your repositories. Search for the repository that you wish to connect by entering its name into the search field.  Click on it when it appears in the search results. Once you connect a repository, it will be available in the initial \"Connect a repository\" dialogue in all spaces where the Bitbucket integration has been added. How to disconnect a repository Click on the the apps menu (arrow in the upper right-hand corner of your space.  Select \"Bitbucket.\" Click on the repository that you want to disconnect. Select \"Disconnect\". Click \"Yes\" to confirm. How to add a Bitbucket pull request to a task In the Workast web app, open the task details screen by clicking on your task.   Click on the ellipses (three dots - the task menu) in the task header and select \"Attach Pull Request.\" A dialogue will open with a list of your connected repositories.  Choose the repository by clicking on it.  (If you only have one connected repository, this step may be bypassed.) Once you select a repository, you'll be presented with a list of all the available pull requests.  Only open pull requests will be listed. Click on your pull request to attach it to the task. Quick note - if you click on a repository with no pull requests, you'll need to use close the dialogue by clicking on the X. Seeing the pull request results in your task When a pull request is merged, the merge will be confirmed in your task: When a pull request is declined, it will also be confirmed in your task: ","seo_data":{"meta_title":"Using the Bitbucket integration","meta_description":""},"tags":["apps","integrations","bitbucket","developer"],"attachments":[],"cloud_files":[],"thumbs_up":0,"thumbs_down":0,"hits":11,"feedback_count":0},{"id":61000165177,"type":1,"status":2,"agent_id":61001167161,"created_at":"2020-03-04T01:30:34Z","category_id":61000063757,"folder_id":61000093543,"title":"Incoming Webhooks","updated_at":"2021-01-04T23:08:38Z","description":"Incoming Webhooks are a simple way to create tasks inside Workast from external sources. They make use of normal HTTP requests with a JSON payload that includes the task text and some additional details. 

The Incoming Webhooks app

To get started, you need to add the Incoming Webhooks application to the space where you want to be creating tasks. Click on ellipses (three dots) in the top right corner of the space and then on \"Manage apps\" from the menu.   Scroll down, and select \"Add\" next to \"Incoming Webhooks.\"   Click the X in the top right-hand corner to return to your space. 

 

Creating a Webhook URL

  

Creating your first taskThe Webhook URL accepts the HTTP POST method with the header Content-Type: application/json with the task details as JSON body.
If you are familiar with curl, you can try to create a task right away curl -XPOST -H \"Content-type: application/json\" -d '{\"text\": \"A task from the new webhook URL\"}' 'https://hooks.workast.app/your-token' 

More than just textYou can add a description, assign the task, set a start date and a due date. Here is the full payload that is accepted by the Webhook URL.
{\n  \"text\": \"string\",\n  \"description\": \"string\",\n  \"assignedTo\": [\n    \"USERID\"\n  ],\n  \"assignedToEmail\": [\n    \"user@email\"\n  ],\n  \"startDate\": \"2019-03-20\",\n  \"dueDate\": \"2019-03-20\",\n  \"subListId\": \"5a9cf7219285...\" // The list ID within the space\n} 
Please note: dates should be in UTC","description_text":"Incoming Webhooks are a simple way to create tasks inside Workast from external sources. They make use of normal HTTP requests with a JSON payload that includes the task text and some additional details.  The Incoming Webhooks app To get started, you need to add the Incoming Webhooks application to the space where you want to be creating tasks. Click on ellipses (three dots) in the top right corner of the space and then on \"Manage apps\" from the menu.   Scroll down, and select \"Add\" next to \"Incoming Webhooks.\"   Click the X in the top right-hand corner to return to your space.    Creating a Webhook URL Click on either the webhook icon or the ellipses (three dots) in the top right corner of you app and select and select \"Incoming Webhooks.\"   A dialogue box will open.  Select \"Create new webhook.\" Give a name to your webhook URL and click on Create A new dialog will show up with your webhook details. From here, copy the webhook URL that was recently created (https://hooks.workast.app/..)  NOTE: Keep this URL safe. Anyone that has access to the URL will be able to create tasks in your Space.    Creating your first taskThe Webhook URL accepts the HTTP POST method with the header Content-Type: application/json with the task details as JSON body. If you are familiar with curl, you can try to create a task right away curl -XPOST -H \"Content-type: application/json\" -d '{\"text\": \"A task from the new webhook URL\"}' 'https://hooks.workast.app/your-token'  More than just textYou can add a description, assign the task, set a start date and a due date. Here is the full payload that is accepted by the Webhook URL. {\n  \"text\": \"string\",\n  \"description\": \"string\",\n  \"assignedTo\": [\n    \"USERID\"\n  ],\n  \"assignedToEmail\": [\n    \"user@email\"\n  ],\n  \"startDate\": \"2019-03-20\",\n  \"dueDate\": \"2019-03-20\",\n \"subListId\": \"5a9cf7219285...\" // The list ID within the space\n}  Please note: dates should be in UTC","seo_data":{"meta_title":"","meta_description":""},"tags":["webhooks"],"attachments":[],"cloud_files":[],"thumbs_up":5,"thumbs_down":0,"hits":17,"feedback_count":0},{"id":61000165235,"type":1,"status":2,"agent_id":61003830981,"created_at":"2020-03-04T01:30:48Z","category_id":61000063757,"folder_id":61000093543,"title":"How to generate an API token","updated_at":"2021-01-04T23:08:38Z","description":"

To generate an API token:

Looking for more developer tools? Check out our Bitbucket and Github integrations! 
","description_text":" To generate an API token: Log into the web app. Click on the arrow next to your name in the top left corner.  Select \"Preferences.\" Your preferences screen will open.  Scroll down to \"API Token.\" Click \"Generate Token.\"  Select and copy the provided token.  Click \"Done\" to close the panel. You can then use the token to interact with the API at https://developers.workast.com Looking for more developer tools? Check out our Bitbucket and Github integrations!  ","seo_data":{"meta_title":"","meta_description":""},"tags":["API"],"attachments":[],"cloud_files":[],"thumbs_up":0,"thumbs_down":0,"hits":4,"feedback_count":0}],"category":{"id":61000063757,"name":"Extensions","description":null,"created_at":"2020-02-27T22:50:16Z","updated_at":"2020-12-09T19:40:41Z"},"folder":{"id":61000093543,"name":"Developer extensions","description":"Development extensions such as Bitbucket and how to generate API tokens","visibility":1,"created_at":"2020-02-27T22:50:16Z","updated_at":"2020-12-11T00:30:26Z"}}}}