Discord

👍Pro Integration

The Discord integration is available to all users signed up after September '23, the legacy Starter and Pro plans, and Enterprise plans. If you're on a legacy Free plan and want to access this integration, migrate to our new pricing via your billing settings.

Receive instant updates on your Discord server from RevenueCat whenever a new purchase event occurs in your app.

Events

The Discord 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 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 for more details on updates, downgrades, and crossgrades.	✅	✅	❌	✅	❌

Configure Discord server

You need to configure your Discord server to authorize a webhook to post to your workspace. Please follow this Discord article on their website explaining how to set this up.

Configure RevenueCat Integration

Once you've set up a webhook in your Discord server. Enter the details into the Discord Integration section of your dashboard.

👍

You're all set! RevenueCat will start sending events into Discord!

Sample Events

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

Initial Purchase

{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just started a subscription.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly_1",
                        "inline": true
                    },
                    {
                        "name": "Revenue",
                        "value": "$5.99",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Trial Started

{
    "product_identifier": "monthly_3d_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just started a free trial.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly_3d_trial",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Trial Converted

{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just converted from a free trial.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly_1",
                        "inline": true
                    },
                    {
                        "name": "Revenue",
                        "value": "$5.99",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Trial Cancelled

{
    "product_identifier": "monthly_3d_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":pouting_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just cancelled their free trial.",
                "color": 15548997,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly_3d_trial",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Renewal

{
    "product_identifier": "monthly_1",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just renewed their subscription.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly_1",
                        "inline": true
                    },
                    {
                        "name": "Revenue",
                        "value": "$5.99",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Cancellation

{
    "product_identifier": "annual",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":crying_cat_face: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just cancelled their subscription.",
                "color": 15548997,
                "fields": [
                    {
                        "name": "Product",
                        "value": "annual",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Non Subscription Purchase

{
    "product_identifier": "500_coins",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just made a purchase.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "500_coins",
                        "inline": true
                    },
                    {
                        "name": "Revenue",
                        "value": "$5.99",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Billing Issue

{
    "product_identifier": "annual_trial",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":scream_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> got a billing issue.",
                "color": 15548997,
                "fields": [
                    {
                        "name": "Product",
                        "value": "annual_trial",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}

Product Change

{
    "product_identifier": "annual",
    "app_id": "12345678-1234-1234-1234-123456789012",
    "payload": {
        "username": "RevenueCat",
        "avatar_url": "https://app.revenuecat.com/favicon-96x96.png",
        "embeds": [
            {
                "description": ":smiley_cat: Customer <https://app.revenuecat.com/activity/123abcd45/12345|12345> just changed the product of their subscription.",
                "color": 5763719,
                "fields": [
                    {
                        "name": "Product",
                        "value": "monthly",
                        "inline": true
                    }
                ],
                "timestamp": "2023-10-26T17:21:32Z"
            }
        ]
    }
}