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 )
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 firstname.lastname@example.org 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.