# Heroku

[<mark style="color:blue;">Heroku</mark>](https://www.heroku.com/) is a platform as a service (PaaS) that enables developers to build, run and operate applications entirely in the cloud.

Route detailed alerts from Heroku to the right users in Squadcast.

### How to integrate Heroku with Squadcast

### In Squadcast: Using Heroku as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Heroku**. Copy the displayed **Webhook URL** to [configure](#in-heroku-set-up-a-webhook-for-squadcast) it within **Heroku.** Finish by clicking **Add Alert Source** -> **Done**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-3875126fa26a4c40225f2998aaee93e6020bb0da%2FHeroku.png?alt=media\&token=484405bc-e905-49af-a856-9d2c55a30b2f)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### In Heroku: Set up a Webhook for Squadcast

**(1)** Navigate to the Dashboard page for your application. In the drop-down menu below, select **More**. You will see an option to **View Webhooks** that will take you to the Webhooks creation and management interface

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-e8e330fae54f55367aa4a68435b755e1a7b48817%2Fheroku_2.png?alt=media\&token=7f88f886-cbf2-4b55-918e-48c2defb3021)

**(2)** Here, click on **Create Webhook**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-d74ff7ba154e8750c3d8e889ba1394fb30512349%2Fheroku_3.png?alt=media\&token=73bc2b10-3135-4279-9caf-50b90c6b74aa)

**(3)** Provide a suitable **Name** for the Webhook, paste the previously copied **Webhook URL**, select all the checks for which you want to create incidents in Squadcast and click on **Add Webhook**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-532660716899b790159ea86091ff92dbfea2441f%2Fheroku_4.png?alt=media\&token=912c5b94-b2d9-4199-9fbf-a36e4432e819)

This completes the configuration of a Webhook in Heroku for Squadcast!

#### Supported Entities and Event Types

The below table indicates the Heroku Entities for which this integration would trigger and resolve incidents in Squadcast. If `Resolve` is mentioned against an Entity, it means the triggered incident in Squadcast will be automatically resolved when Heroku sends a resolve signal for it. For the other Entities, Squadcast users will be notified for the triggered incident. They will have to manually resolve these incidents in Squadcast once the issues are fixed in Heroku.

| Heroku Entities  | Squadcast Incident Event Types |
| ---------------- | ------------------------------ |
| addon-attachment | Trigger                        |
| addon            | Trigger                        |
| app              | Trigger                        |
| build            | Trigger, Resolve               |
| collaborator     | Trigger                        |
| domain           | Trigger                        |
| dyno             | Trigger, Resolve               |
| formation        | Trigger                        |
| release          | Trigger                        |
| sni-endpoint     | Trigger                        |
| ssl-endpoint     | Trigger                        |

#### Helpful Links to Heroku's Documentation

**1.** You can find more details about Entities and Event Details [here](https://devcenter.heroku.com/articles/app-webhooks#step-2-determine-which-events-to-subscribe-to)

**2.** You can find more information on setting Webhooks up [here](https://devcenter.heroku.com/articles/app-webhooks).

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*