---
id: "integrations/third-party-integrations/slack"
title: "Slack"
description: "RevenueCat can send you Slack message to a channel any time an event happens in your app. This lets you keep a close pulse on your app and celebrate those money making moments!"
permalink: "/docs/integrations/third-party-integrations/slack"
slug: "slack"
version: "current"
original_source: "docs/integrations/third-party-integrations/slack.mdx"
---

> **AI agents:** This is the Markdown version of a RevenueCat documentation page. For the complete documentation index, see [llms.txt](https://www.revenuecat.com/docs/llms.txt).

RevenueCat can send you Slack message to a channel any time an event happens in your app. This lets you keep a close pulse on your app and celebrate those money making moments!

### Integration at a Glance

| Includes Revenue | Supports Negative Revenue | Sends Sandbox Events  | Includes Customer Attributes | Sends Transfer Events | Optional Event Types |
| :--------------: | :-----------------------: | :-------------------: | :--------------------------: | :-------------------: | :------------------: |
|        ✅        |            ❌             | Toggle on in Settings |              ❌              |          ❌           |          ❌          |

## Events

The Slack integration tracks the following events:

| Event Type                | Default Event Name (Fallback)                                                           | Description                                                                                                                                                                                                                                                         | App Store | Play Store | Amazon | Stripe | Promo |
| ------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ---------- | ------ | ------ | ----- |
| Initial Purchase          | Customer `<user_id>` just started a subscription of `<product_id>`                      | A new subscription has been purchased.                                                                                                                                                                                                                              | ✅        | ✅         | ✅     | ✅     | ❌    |
| Trial Started             | Customer `<user_id>` just started a free trial of `<product_id>`                        | The start of an auto-renewing subscription product free trial.                                                                                                                                                                                                      | ✅        | ✅         | ✅     | ✅     | ❌    |
| Trial Converted           | Customer `<user_id>` just converted from a free trial of `<product_id>`                 | When an auto-renewing subscription product converts from a free trial to normal paid period.                                                                                                                                                                        | ✅        | ✅         | ✅     | ✅     | ❌    |
| Trial Cancelled           | Customer `<user_id>` just cancelled their free trial of `<product_id>`                  | When a user turns off renewals for an auto-renewing subscription product during a free trial period.                                                                                                                                                                | ✅        | ✅         | ✅     | ✅     | ❌    |
| Renewal                   | Customer `<user_id>` just renewed their subscription of `<product_id>`                  | An existing subscription has been renewed or a lapsed user has resubscribed.                                                                                                                                                                                        | ✅        | ✅         | ✅     | ✅     | ❌    |
| Cancellation              | Customer `<user_id>` just cancelled their subscription of `<product_id>`                | A subscription or non-renewing purchase has been cancelled. See [cancellation reasons](https://www.revenuecat.com/docs/integrations/webhooks/event-types-and-fields#cancellation-and-expiration-reasons) for more details.                                                                         | ✅        | ✅         | ✅     | ✅     | ✅    |
| Non Subscription Purchase | Customer `<user_id>` just purchased `<product_id>`                                      | A customer has made a purchase that will not auto-renew.                                                                                                                                                                                                            | ✅        | ✅         | ✅     | ✅     | ✅    |
| Billing Issue             | Customer `<user_id>` got a billing issue on `<product_id>`                              | There has been a problem trying to charge the subscriber. This does not mean the subscription has expired. Can be safely ignored if listening to CANCELLATION event + cancel\_reason=BILLING\_ERROR.                                                                  | ✅        | ✅         | ✅     | ✅     | ❌    |
| Product Change            | Customer `<user_id>` got a product change from `<old_product_id>` to `<new_product_id>` | A subscriber has changed the product of their subscription. This does not mean the new subscription is in effect immediately. See [Managing Subscriptions](https://www.revenuecat.com/docs/subscription-guidance/managing-subscriptions) for more details on updates, downgrades, and crossgrades. | ✅        | ✅         | ❌     | ✅     | ❌    |

## Configure Slack Workspace

Before RevenueCat can post to your Slack channel, you need to authorize a webhook to post to your workspace. Slack has a more [detailed article](https://get.slack.help/hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack) on their website explaining how to set this up if you have trouble.

### 1. Create a **Slack app**

- Navigate to [https://api.slack.com/apps](https://api.slack.com/apps?new_app=1) and create a new app. Give it a name like "RevenueCat" and select your workspace.

![](https://www.revenuecat.com/docs_images/integrations/third-party-integrations/slack/slack-app-creation.png)

- Click **Create App**

### 2. Enable **Incoming Webhooks** from the settings page

![](https://www.revenuecat.com/docs_images/integrations/third-party-integrations/slack/slack-enable-webhooks.png)

1. Select **Incoming Webhooks** from the sidebar
2. Enable the Incoming Webhooks toggle
3. After the settings page refreshes, click **Add New Webhook to Workspace**

### 3. Pick a channel that the app will post to, then click **Authorize**

![](https://www.revenuecat.com/docs_images/integrations/third-party-integrations/slack/slack-authorize-channel.png)

## Configure RevenueCat Integration

1. Navigate to your project settings in the RevenueCat dashboard and choose 'Slack' from the Integrations menu

![Integration setup](https://www.revenuecat.com/docs_images/integrations/setup-integrations.png)

2. Enter your configuration details.

:::success
You're all set! RevenueCat will start sending events into Slack!
:::

![](https://www.revenuecat.com/docs_images/integrations/third-party-integrations/slack/slack-successful-event.png)

## Sample Events

Below are sample JSONs that are delivered to Slack for each event type.

**Initial Purchase**

```json
{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just started a subscription of monthly_1",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just started a subscription."
                    },
                    {
                        "title": "Product",
                        "value": "monthly_1",
                        "short": false
                    },
                    {
                        "title": "Revenue",
                        "value": "$5.99",
                        "short": false
                    }
                ],
                "ts": 1588335655
            }
        ]
    }
}
```

**Trial Started**

```json
{
    "product_identifier": "monthly_3d_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just started a free trial of monthly_3d_trial",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just started a free trial."
                    },
                    {
                        "title": "Product",
                        "value": "monthly_3d_trial",
                        "short": false
                    }
                ],
                "ts": 1553805130
            }
        ]
    }
}
```

**Trial Converted**

```json
{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just converted from a free trial of monthly_1",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just converted from a free trial."
                    },
                    {
                        "title": "Product",
                        "value": "monthly_1",
                        "short": false
                    },
                    {
                        "title": "Revenue",
                        "value": "$5.99",
                        "short": false
                    }
                ],
                "ts": 1554466423
            }
        ]
    }
}
```

**Trial Cancelled**

```json
{
    "product_identifier": "monthly_3d_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just cancelled their free trial of monthly_3d_trial",
                "color": "#F2545B",
                "fields": [
                    {
                        "value": ":pouting_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just cancelled their free trial."
                    },
                    {
                        "title": "Product",
                        "value": "monthly_3d_trial",
                        "short": false
                    }
                ],
                "ts": 1554502133
            }
        ]
    }
}
```

**Renewal**

```json
{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just renewed their subscription of monthly_1",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just renewed their subscription."
                    },
                    {
                        "title": "Product",
                        "value": "monthly_1",
                        "short": false
                    },
                    {
                        "title": "Revenue",
                        "value": "$5.99",
                        "short": false
                    }
                ],
                "ts": 1554091875
            }
        ]
    }
}
```

**Cancellation**

```json
{
    "product_identifier": "annual",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just cancelled their subscription of annual",
                "color": "#F2545B",
                "fields": [
                    {
                        "value": ":crying_cat_face: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just cancelled their subscription."
                    },
                    {
                        "title": "Product",
                        "value": "annual",
                        "short": false
                    }
                ],
                "ts": 1553810169
            }
        ]
    }
}
```

**Non-subscription Purchase**

```json
{
    "product_identifier": "500_coins",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 just purchased 500_coins",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just made a purchase."
                    },
                    {
                        "title": "Product",
                        "value": "500_coins",
                        "short": false
                    },
                    {
                        "title": "Revenue",
                        "value": "$4.99",
                        "short": false
                    }
                ],
                "ts": 1590390293
            }
        ]
    }
}
```

**Billing Issue**

```json
{
    "product_identifier": "annual_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 got a billing issue on annual_trial",
                "color": "#F2545B",
                "fields": [
                    {
                        "value": ":scream_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> got a billing issue."
                    },
                    {
                        "title": "Product",
                        "value": "annual_trial",
                        "short": false
                    }
                ],
                "ts": 1663976618
            }
        ]
    }
}
```

**Product Change**

```json
{
    "product_identifier": "annual",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "channel": "purchases",
        "username": "RevenueCat",
        "icon_url": "https://app.revenuecat.com/favicon-96x96.png",
        "attachments": [
            {
                "fallback": "Customer 12345 got a product change from annual to monthly",
                "color": "#30B296",
                "fields": [
                    {
                        "value": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just changed the product of their subscription."
                    },
                    {
                        "title": "Product",
                        "value": "monthly",
                        "short": false
                    }
                ],
                "ts": 1663976617
            }
        ]
    }
}
```
