Integrating with Asana

Beanstalk has a built-in integration with Asana, a team collaboration service. After configuring your repository to work with Asana you can use commands inside your commit messages to post updates to your Asana tasks and mark them as complete/incomplete.

Configuring the integration

In order to use the integration you will need to connect your Beanstalk repository to your Asana account. Please note that you need to be an admin in Beanstalk to setup the integration.

To start, go to your repository then follow navigation to Settings > Integration page and click on Asana logo in the integrations list. Click on the Activate integration button to start the setup process. Beanstalk will then guide you through the process of connecting your repository to Asana, just follow the instructions. You will need your Asana API token handy in order to complete the configuration.

Where to find Asana API Token?

Take a look at the official Asana API documentation to get information about API tokens and their location.

Referencing Asana tasks in your commits

Once the integration is active you will be able to specify Asana task numbers in your commit messages to associate those commits with Asana tasks:

  <code>Commit message [#22575999248374]

When Beanstalk receives this commit it will connect to your Asana account, find a task with the ID you specified and post information about the commit to it with a link back to your Beanstalk repository. Link to that Asana task will also appear on Activity and Changeset pages in Beanstalk for quick access.

Unfortunately there's no way to grab task ID in Asana other than copy it from the URL. To copy the task ID, click on the task that you wish to update via Beanstalk, then copy the long number at the end of your URL.

Mark Asana tasks as complete from commits

In addition to simply referencing tasks from your commits you can also mark them as complete/incomplete:

  <code>Commit message [#22575999248374 status: complete]

After receiving this commit Beanstalk will mark this task as complete. Nice and simple! And if you want to reopen a previously completed task, use the incomplete status:

  <code>Commit message [#22575999248374 status: incomplete]

Missing something?

If there's something lacking in our integration with Asana or you want it to be improved, do let us know. We love working on our integrations with other services to make them easy to use and useful.

Please Note: Only the account owner and admins are allowed to activate integrations.