Discord

Send in-app subscription events to Discord

👍

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 TypeDefault Event Name (Fallback)DescriptionApp StorePlay StoreAmazonStripePromo
Initial PurchaseCustomer <user_id> just started a subscription of <product_id>A new subscription has been purchased.
Trial StartedCustomer <user_id> just started a free trial of <product_id>The start of an auto-renewing subscription product free trial.
Trial ConvertedCustomer <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 CancelledCustomer <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.
RenewalCustomer <user_id> just renewed their subscription of <product_id>An existing subscription has been renewed or a lapsed user has resubscribed.
CancellationCustomer <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 PurchaseCustomer <user_id> just purchased <product_id>A customer has made a purchase that will not auto-renew.
Billing IssueCustomer <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 ChangeCustomer <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.

{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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"
            }
        ]
    }
}
{
    "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_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"
            }
        ]
    }
}