> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Heroku Configuration

> Configure Heroku integration to automatically capture build events and release deployments as contextual pulses for incident correlation.

The Heroku integration records build and release events from your Heroku apps as [pulses](/configuration/pulses) in Rootly, so responders can correlate deployments with incidents directly on the incident timeline. If an incident starts shortly after a release, the pulse feed makes that connection obvious.

Rootly will **automatically** add the following Heroku events as pulses:

* A build starts

* A build ends (Failed or succeeded)

* A release is deployed

* More to come...

## How It Works

Once connected via OAuth, Rootly creates webhooks on the Heroku apps you list in the integration settings and ingests their build and release events. Each pulse includes context like the commit SHA and the user who triggered the build, and pulses are automatically linked to Rootly [services](/configuration/services) with a matching **Heroku App Name** field — set this field on each service you want correlated with deployments.

Only explicitly listed apps are monitored, so you control exactly which deployment activity shows up in Rootly.

Beyond pulses, the integration also provides a **Run Command on Heroku** workflow action that executes one-off commands on a dyno — useful for rollbacks or diagnostic scripts mid-incident — and posts the output to Slack.

Ready to configure the Heroku integration? See [Heroku integration setup](/integrations/heroku).

***

## Related Pages

<CardGroup cols={3}>
  <Card title="Pulses" icon="heart-pulse" href="/configuration/pulses">
    Where Heroku build and release events appear as change events on incident timelines.
  </Card>

  <Card title="Services" icon="server" href="/configuration/services">
    Link services to specific Heroku apps via the Heroku App Name field.
  </Card>

  <Card title="Heroku Integration Setup" icon="server" href="/integrations/heroku">
    Full installation guide plus the Run Command workflow action.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.