---
title: Notify your team about APM application deployments
source: https://docs.newrelic.com/docs/change-tracking/change-tracking-webhooks
---

After you record a deployment for an APM application entity, you can keep your team informed about those changes through the use of a webhook. These are available whether you record your deployment using the change tracking feature or the older [REST API](https://docs.newrelic.com/docs/apm/apm-ui-pages/events/record-deployments/#api-instructions).

## Required permissions [#requirements]

Change tracking notification settings require specific [permissions](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-user-management/user-permissions):

-   To `create` the webhook: `Modify` permissions for `Alerts > Destinations` and `Alerts > Channels`.
-   To `view` and `test` the webhook: `View` permissions for `Alerts > Destinations` and `Alerts > Channels`.
-   To `modify` the webhook: `View` permissions for `Alerts > Destinations` and `Alerts > Channels`, and `Modify` on `Alerts > Destinations`.
-   To `delete` the webhook: `Delete` permissions for `Alerts > Destinations` and `Alerts > Channels`.

## Get your webhook destination URL [#get-webhook-url]

You can send deployment data to a variety of webhook destinations. Follow the instructions for the tool you're using to get the webhook URL. Once you have the URL, complete the steps in the next section to configure webhook notifications.

If you're using Slack, follow the instructions here to set up the legacy New Relic alerts app:

1.  Log in to your Slack account as an admin, and then go to **Apps**.
2.  Search for **New Relic Alerts**, and click on that tile.
3.  In the **New Relic Alerts** listing, click the **Configuration** button below the New Relic icon.
4.  Click the **Configuration** tab below the heading **New Relic Alerts**.
5.  On the **Configuration** tab, click the pencil icon.
6.  Scroll down to the **Webhook URL** section, and click **Copy URL**.

## Configure webhook notifications for tracked changes [#configure-webhook]

Insert the webhook URL in the New Relic UI:

1.  Go to the deployment notifications configuration screen: **[one.newrelic.com](https://one.newrelic.com/) > (user menu) > Administration > Integrations > Deploy notifications**.
2.  Paste your webhook URL into the **Webhook URL** field and click **Save**.
3.  Click **Send a test request** to send an example payload with artificial data to your webhook URL.
    ![A screenshot showing how to test the webhook](https://docs.newrelic.com/images/tracking_screenshot-crop_webhook_test.webp "A screenshot showing how to test the webhook")
4.  Under **Toggle this webhook**, you can disable or re-enable the webhook notification by sliding the toggle.
5.  To permanently delete the webhook notification configuration, click **Delete this webhook**.

## Notification payload structure [#payload-structure]

When your deployment notification is enabled and you start tracking a change, your webhook will receive a `POST` request with a payload of type `application/x-www-form-urlencoded`. The keys and values are encoded in key-value tuples separated by an `&`, with an `=` symbol between the key and the value. Non-alphanumeric characters in both keys and values will be URL-encoded.

The following keys and values will be sent, based on the attributes of the deployment and of the APM application entity that was deployed.

| Key                | Value                                                        |
| ------------------ | ------------------------------------------------------------ |
| `created_at`       | The timestamp of the deployment in ISO 8601 format           |
| `application_name` | The name of the APM application entity                       |
| `account_name`     | The name of the account that owns the APM application entity |
| `changelog`        | A list of changes included in the deployment                 |
| `description`      | A description of the deployment                              |
| `revision`         | The version of the deployed software                         |
| `deployment_url`   | A link to the deployments UI for the APM application entity  |
| `deployed_by`      | The user who deployed the application                        |

[Set up using NerdGraph](https://docs.newrelic.com/docs/change-tracking/config/nerdgraph)

Learn how to set up change tracking for your entities using NerdGraph to monitor them in New Relic.

[Set up using CLI](https://docs.newrelic.com/docs/change-tracking/config/cli)

Learn how to set up change tracking for your entities using CLI to monitor them in New Relic.

[View and analyze changes](https://docs.newrelic.com/docs/change-tracking/view-analyze-data/)

Learn advanced techniques for correlating change data with performance metrics and system behavior.