Deploy Hooks

Table of Contents

Deploy hooks allow you to receive a notification whenever a new version of your app is pushed to Heroku. It’s useful to keep you and your team informed about deploys, while it can also be used to integrate different systems together.

After one or more hooks are setup, git push will show that they are scheduled to run:

Each deploy hook is its own add-on. This allows you to pick and choose one or more that you want. The deploy hooks include email, IRC, Basecamp, Campfire, HipChat and a generic HTTP hook. You can create and configure each deployhook through the Heroku Dashboard as well as through the command-line.

Dashboard

Once you create the add-on, you can then configure it by navigating to the app in the Heroku Dashboard, going to the Resources tab and then clicking on the Deploy Hooks add-on you want to configure. The Deploy Hooks add-on configuration page will accept these variables.

Email

This hook will send one or more emails. You can specify the subject and body, as follows:

HipChat

This hook wil post a message to a HipChat room of your choice on app push. An authentication key is required for Heroku to access your HipChat account. To create one, fill out the form found in API Auth Tokens (available to group admins only). For maximum safety, set the type to “notification”.

To make Heroku send notices to a HipChat room on deploy, do the following:

Known issues and limitations

The git_log variable is only supported when using the git deployment mechanism.

With Pipeline promotion and GitHub automatic or manual deploys, DeployHooks does not have access to your git log and you will see the git_log variable be blank. The git_log variable can only be set with a pure git deployment (e.g. git push heroku master).