FireHydrant directly integrates with Heroku and lets you link your Heroku applications to FireHydrant components and their environments. This means you can get automatic Changelog entries the moment your Heroku applications deploy. Changes also appear in your incidents or Slack channels as they are released to linked Heroku apps.

Authorizing Heroku

You must be logged in as a Organization Owner to authorize Heroku to your FireHydrant account. Travel to https://firehydrant.io/organizations/integrations and click the link to connect Heroku.

You'll be asked for permission by Heroku to allow FireHydrant access,  Click "Allow".

You'll see a success message indicating that FireHydrant now has access to Heroku. From here, let's link a component and environment to a Heroku application.

Linking Components to Heroku applications

Since Heroku doesn't have the notion of "environments" like FireHydrant does, we need to specify which applications on Heroku represent which environment in FireHydrant. This process is done by going into a component and editing its Heroku configuration.

To edit these mappings, click Components in the navigation, then Edit for any of your components, then Link Heroku Apps, and finally, Add Heroku App. You should see a page that looks like:


On this page, select the Heroku application in your account and the environment that you'd like it to represent for this component in FireHydrant. Once done, click Save.

Changelog Updates

After you've assigned this mapping, FireHydrant configures a webhook for the application to be sent anytime a release is created for the application. FireHydrant will create changelog updates anytime we receive this webhook now automatically.

That's it! You're now set to start receiving release updates in FireHydrant from Heroku. All of these change updates are also sent to incidents or Slack channels where an active incident is occurring.

Did this answer your question?