--- id: "integrations/third-party-integrations/discord" title: "Discord" description: "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." permalink: "/docs/integrations/third-party-integrations/discord" slug: "discord" version: "current" original_source: "docs/integrations/third-party-integrations/discord.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). :::success\[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](https://app.revenuecat.com/settings/billing). ::: 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 \ just started a subscription of \ | A new subscription has been purchased. | ✅ | ✅ | ✅ | ✅ | ❌ | | Trial Started | Customer \ just started a free trial of \ | The start of an auto-renewing subscription product free trial. | ✅ | ✅ | ✅ | ✅ | ❌ | | Trial Converted | Customer \ just converted from a free trial of \ | When an auto-renewing subscription product converts from a free trial to normal paid period. | ✅ | ✅ | ✅ | ✅ | ❌ | | Trial Cancelled | Customer \ just cancelled their free trial of \ | When a user turns off renewals for an auto-renewing subscription product during a free trial period. | ✅ | ✅ | ✅ | ✅ | ❌ | | Renewal | Customer \ just renewed their subscription of \ | An existing subscription has been renewed or a lapsed user has resubscribed. | ✅ | ✅ | ✅ | ✅ | ❌ | | Cancellation | Customer \ just cancelled their subscription of \ | 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 \ just purchased \ | A customer has made a purchase that will not auto-renew. | ✅ | ✅ | ✅ | ✅ | ✅ | | Billing Issue | Customer \ got a billing issue on \ | 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 \ got a product change from \ to \ | 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 Discord server You need to configure your Discord server to authorize a webhook to post to your workspace. Please follow this Discord [article](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) 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 ![Integration setup](https://www.revenuecat.com/docs_images/integrations/setup-integrations.png) 2. Enter the details into the Discord Integration section of your [dashboard](https://app.revenuecat.com). :::success\[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** ```json { "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 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** ```json { "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 just started a free trial.", "color": 5763719, "fields": [ { "name": "Product", "value": "monthly_3d_trial", "inline": true } ], "timestamp": "2023-10-26T17:21:32Z" } ] } } ``` **Trial Converted** ```json { "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 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** ```json { "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 just cancelled their free trial.", "color": 15548997, "fields": [ { "name": "Product", "value": "monthly_3d_trial", "inline": true } ], "timestamp": "2023-10-26T17:21:32Z" } ] } } ``` **Renewal** ```json { "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 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** ```json { "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 just cancelled their subscription.", "color": 15548997, "fields": [ { "name": "Product", "value": "annual", "inline": true } ], "timestamp": "2023-10-26T17:21:32Z" } ] } } ``` **Non Subscription Purchase** ```json { "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 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** ```json { "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 got a billing issue.", "color": 15548997, "fields": [ { "name": "Product", "value": "annual_trial", "inline": true } ], "timestamp": "2023-10-26T17:21:32Z" } ] } } ``` **Product Change** ```json { "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 just changed the product of their subscription.", "color": 5763719, "fields": [ { "name": "Product", "value": "monthly", "inline": true } ], "timestamp": "2023-10-26T17:21:32Z" } ] } } ```