ZenHub integrations

Slack

Want to stay in the loop across any device? ZenHub provides integrations with industry standards like Slack, HipChat, Spark, Gitter, or something totally custom.

To configure an integration, visit the ZenHub Dashboard and select the Integrations tab. Here, you can configure ZenHub to post important GitHub project updates to third-party services. Your team will be kept updated on important project changes related to ZenHub, and you can further pair it with GitHub's integrations for an even more comprehensive picture of your team's project activity.

You can be updated when...

  • An Issue changes from one pipeline to another ( i.e. from “In Progress” to “Review” )
  • An estimate is set, updated, or cleared
  • An Issue is moved up or down in a pipeline ( reprioritized )

Read and write API

Want to generate custom reports or manipulate your team's ZenHub data? ZenHub provides an REST API with JSON responses for this purpose. See the full API documentation. ZenHub's API can be used alone or in tandem with GitHub's robust API.

The ZenHub API provides a variety of endpoints. Current endpoints include:

  • Issue data (An Issue's Estimate, pipeline, and a true/false Epic flag)
  • Issue events (Historical changes to a specific GitHub Issue)
  • Board data for a repository (Board pipelines, the Issues in each pipeline; plus Issue numbers, Issue position on the board, estimates, and a true/false Epic flag)
  • Epics for a repository
  • Epic data (including estimates and position on the Board)
  • Move Issues between pipelines
  • Add estimates to Issues
  • Convert Issues to Epics
  • Convert Epics to Issues
  • Add or remove Issues to Epics

Write API use cases

From building gadgets to automating workflows migrating data, here's a few of our favorite automations that can be created using the write API:

  • Sprint planning with a distributed or remote team or perhaps looking for a way improve your estimations and plan more accurately? Using the Add estimates to Issues endpoint you can now make sprint planning accessible to everyone on your team by building a Planning Poker application that can help automate the addition of estimates to your existing GitHub Issues.
  • Have a custom Slack bot that migrates conversations to your GitHub Issues? From having your bot find and move Issues across pipelines to converting Issues to Epics based on conversations happening you can now make your bot more robust!
  • Automate the movement of Issues within or across pipelines to manage priority based on meaningful actions being taken on an Issue. If an Issue is stale, raise its position within a pipeline or transfer it back to the backlog for discussion. If an Issue gets tagged with an urgent label, raise its position in your pipeline to signal severity.
  • Integrate products you're already using such as CircleCI or Travis into your ZenHub workflow by automating the movement of Issues between pipelines when a build finishes or a test passes.

Create a gadget or helpful custom program using our API? Send us a note at support@zenhub.com We love to hear how our users are enhancing their ZenHub experience.

Adding an integration

To add a new integration, visit the Integrations tab on the ZenHub Dashboard, then choose a service to integrate with.

Select the GitHub repository you'd like updates for, then follow the instructions to generate a webhook.

Note: The “How to create a webhook” link changes depending on the service you've selected. If you've selected Slack, you'll be able to use the simple Add to Slack button. Finally, add the generated webhook to complete the integration.