AI agents: the complete RevenueCat documentation index is available at llms.txt. A Markdown version of this page is available at this URL.

Discord

Send in-app subscription events to Discord

Ask AI

Copied as markdown!

👍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

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

2. 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"
            }
        ]
    }
}

Was this page helpful?