Intercom
Send in-app subscription events from RevenueCat to Intercom
The Intercom integration is available on the Pro plan.
Intercom can be a helpful integration tool in understanding what stage a customer is in and reacting accordingly. You can use Intercom’s comprehensive communication and engagement system to retain customers.
With our Intercom integration, you can:
- Create Intercom filters for users that canceled free trials.
- Allow customer support to communicate with loyal users with access to all the information they need to solve their problem or even grant them a promotional subscription.
- Send an onboarding campaign to a user in a free trial
With accurate and up-to-date subscription data in Intercom, you'll be set to turbocharge your customer support ⚡️
Events
The Intercom integration tracks the following events:
Event | Description |
---|---|
Initial Purchase | A new subscription has been purchased or a lapsed user has resubscribed. |
Trial Started | The start of an auto-renewing subscription product free trial. |
Trial Converted | When an auto-renewing subscription product converts from a free trial to normal paid period. |
Trial Cancelled | When a user turns off renewals for an auto-renewing subscription product during a free trial period. |
Renewal | When an existing subscription has been renewed. |
Cancellation | When a user turns off renewals for an auto-renewing subscription product during the normal paid period. |
Non Subscription Purchase | The purchase of any product that's not an auto-renewing subscription. |
Expiration | A subscription has expired and access should be removed. |
Billing Issues | There has been a problem trying to charge the subscriber. This does not mean the subscription has expired (in the case of a grace period enabled). |
Product Change | When user 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. |
Setup
1. Connect with Intercom
- Navigate to your project in the RevenueCat dashboard and find the Integrations card in the left menu. Select + New

- Choose Intercom from the Integrations menu
- Click the Connect with Intercom button in your project settings.

2. Set Event Names
Once your account is connected, you can configure the event names that we'll send to Intercom. If you leave any field blank, we'll just use our default names.

You're all set!
That's all there is to it! You'll now be seeing subscription events in Intercom. Woohoo!
Sample Events
Below are sample JSONs that are delivered to Intercom for each event.
{
"product_identifier": "one_week_premium",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "PLAY_STORE",
"latest_entitlement": "pro",
"expires_at": 1663252169
}
},
"event_payload": {
"event_name": "initial_purchase",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1662992969,
"metadata": {
"product_identifier": "one_week_premium",
"entitlement": "pro",
"store": "PLAY_STORE",
"expires_at": 1663252169
}
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662992969,
"event_name": "trial_started",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663252169,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663252169,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662993211,
"event_name": "trial_cancelled",
"metadata": {
"app_id": "app1234567890",
"cancellation_reason": "UNSUBSCRIBE",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663252169,
"product_identifier": "premium_sub",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "premium_sub",
"user_payload": {
"custom_attributes": {
"expires_at": 1663252169,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1663021598,
"event_name": "trial_converted",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663626398,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663626398,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1663021649,
"event_name": "renewal",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663626449,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663626449,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662993557,
"event_name": "cancellation",
"metadata": {
"app_id": "app1234567890",
"cancellation_reason": "UNSUBSCRIBE",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663529651,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663529651,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"product_identifier": "one_month_pro",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "APP_STORE",
"latest_entitlement": "pro",
"expires_at": 1652444925
}
},
"event_payload": {
"event_name": "expiration",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1652444925,
"metadata": {
"product_identifier": "one_month_pro",
"entitlement": "pro",
"store": "APP_STORE",
"expires_at": 1652444925,
"environment": "production",
"expiration_reason": "UNSUBSCRIBE"
}
}
}
{
"product_identifier": "100_tokens",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "PLAY_STORE",
"latest_entitlement": null,
"expires_at": null
}
},
"event_payload": {
"event_name": "non_subscription_purchase",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1607569472,
"metadata": {
"product_identifier": "100_tokens",
"entitlement": null,
"store": "PLAY_STORE",
"expires_at": null,
"environment": "production"
}
}
}
Updated about 15 hours ago