Skip to main content

Customer.io

👍Pro Integration

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

Customer.io can be a powerful integration tool for automating targeted messaging based on real-time customer behavior. With Customer.io's flexible automation platform, you can design personalized journeys that adapt to each user's subscription lifecycle.

With our Customer.io integration, you can:

  • Create an onboarding flow for users who have subscribed but have not yet engaged with the tutorial or first steps of your product.
  • Send a push notification to churned users and offer them a discount.

With accurate and up-to-date subscription data in Customer.io, you'll be set to turbocharge your campaigns ⚡️

Integration at a Glance​

Includes RevenueSupports Negative RevenueSends Sandbox EventsIncludes Customer AttributesSends Transfer EventsOptional Event Types
✅✅Requires API key✅❌non_subscription_purchase_event uncancellation_event subscription_paused_event expiration_event billing_issue_event product_change_event

Events​

The Customer.io integration tracks the following events:

EventDefault Event NameDescriptionApp StorePlay StoreAmazonStripePromo
Initial Purchaserc_initial_purchase_eventA new subscription has been purchased.✅✅✅✅❌
Trial Startedrc_trial_started_eventThe start of an auto-renewing subscription product free trial.✅✅✅✅❌
Trial Convertedrc_trial_converted_eventWhen an auto-renewing subscription product converts from a free trial to normal paid period.✅✅✅✅❌
Trial Cancelledrc_trial_cancelled_eventWhen a user turns off renewals for an auto-renewing subscription product during a free trial period.✅✅✅✅❌
Renewalrc_renewal_eventAn existing subscription has been renewed or a lapsed user has resubscribed.✅✅✅✅❌
Cancellationrc_cancellation_eventA subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details.✅✅✅✅✅
Uncancellationrc_uncancellation_eventA non-expired cancelled subscription has been re-enabled.✅✅✅❌❌
Non Subscription Purchaserc_non_subscription_purchase_eventA customer has made a purchase that will not auto-renew.✅✅✅✅✅
Subscription Pausedrc_subscription_paused_eventA subscription has been paused.❌✅❌❌❌
Expirationrc_expiration_eventA subscription has expired and access should be removed. If you have Platform Server Notifications configured, this event will occur as soon as we are notified (within seconds to minutes) of the expiration. If you do not have notifications configured, delays may be approximately 1 hour.✅✅✅✅✅
Billing Issuesrc_billing_issue_eventThere 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 Changerc_product_change_eventA 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.✅✅❌✅❌

For events that have revenue, such as trial conversions and renewals, RevenueCat will automatically record this amount along with the event in Customer.io. Bear in mind that revenue will always be reported in USD. If it's been made with a different currency, we'll automatically convert it to USD. You can find the currency of the original transaction in the currency field of the event.

Setup​

1. Set Customer.io User Identity​

In order to associate RevenueCat data with a Customer.io Person, the RevenueCat $customerioId Attribute should be set in RevenueCat to the Person's cio_id. If this field does not exist, RevenueCat will fallback to using the RevenueCat app user ID as the id. You can read more about how the association works in Customer.io's Identifying people documentation.

2. Send RevenueCat Events to Customer.io​

After you've set up the Purchase SDK and Customer.io SDK to have the same user identity, you can "turn on" the integration and configure the event names from the RevenueCat dashboard.

  1. Navigate to your app in the RevenueCat and find the Integrations card in the left menu. Select + New

  1. Choose Customer.io from the Integrations menu
  2. Add your Site ID and API key
  3. Enter the event names that RevenueCat will send or choose the default event names
  4. Select whether you want sales reported as gross revenue (before app store commission), or after store commission and/or estimated taxes.

Customer.io configuration page

Testing the Customer.io integration​

Make a sandbox purchase with a new user​

Simulate a new user installing your app, and go through your app flow to complete the sandbox purchase.

Check that the Customer.io event delivered successfully​

While still on the Customer View, select the purchase event in the Customer History page and make sure that the Customer.io integration event exists and was delivered successfully.

Check that the Customer.io event was delivered

Check the Customer.io dashboard for the delivered event​

Navigate to your Customer.io dashboard > Activity Logs. In the 'Identified' tab, you will see that an event was delivered and a Person was created.

Check Customer.io Activity Logs

Sample Events​

Below are sample JSONs that are delivered to Customer.io for events.

{
  "batch": [
    {
      "action": "identify",
      "attributes": {
        "aliases": ["$RCAnonymousID:87c6049c58069238dce29853916d624c"],
        "app_id": "appe2a3da5a50",
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "entitlement_ids": ["pro"],
        "original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "platform": "iOS",
        "rc_subscription_status": "active",
        "subscriber_attributes": {}
      },
      "identifiers": {
        "id": "$RCAnonymousID:87c6049c58069238dce29853916d624c"
      },
      "type": "person"
    },
    {
      "action": "event",
      "attributes": {
        "aliases": ["$RCAnonymousID:87c6049c58069238dce29853916d624c"],
        "app_id": "appe2a3da5a50",
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "currency": "USD",
        "entitlement_id": null,
        "entitlement_ids": ["pro"],
        "expiration_at": "2025-03-14T16:52:10Z",
        "is_family_share": false,
        "offer_code": null,
        "original_app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "original_transaction_id": "1123142348431",
        "period_type": "NORMAL",
        "platform": "iOS",
        "presented_offering_id": "null",
        "product_id": "premium",
        "purchased_at": "2025-03-13T16:52:10Z",
        "rc_subscription_status": "active",
        "revenue": 29.99,
        "store": "APP_STORE",
        "subscriber_attributes": {},
        "transaction_id": "1123142348431"
      },
      "id": "d1dca188-6a16-4109-b663-778c0dfe9124",
      "identifiers": {
        "id": "$RCAnonymousID:87c6049c58069238dce29853916d624c"
      },
      "name": "rc_initial_purchase_event",
      "timestamp": 1741884730,
      "type": "person"
    }
  ]
}

Subscription Status Attribute​

Whenever RevenueCat sends an event to Customer.io, we'll update the rc_subscription_status user attribute with any applicable changes, using one of the following values:

StatusDescription
activeThe customer has an active, paid subscription which is set to renew at their next renewal date.
introThe customer has an active, paid subscription through a paid introductory offer.
cancelledThe customer has a paid subscription which is set to expire at their next renewal date.
grace_periodThe customer has a paid subscription which has entered a grace period after failing to renew successfully.
trialThe customer is in a trial period which is set to convert to paid at the end of their trial period.
cancelled_trialThe customer is in a trial period which is set to expire at the end of their trial period.
grace_period_trialThe customer was in a trial period and has now entered a grace period after failing to renew successfully.
expiredThe customer's subscription has expired.
promotionalThe customer has access to an entitlement through a RevenueCat Granted Entitlement
expired_promotionalThe customer previously had access to an entitlement through a RevenueCat Granted Entitlement that has since expired.
pausedThe customer has a paid subscription which has been paused and is set to resume at some future date.

For customers with multiple active subscriptions, this attribute will represent the status of only the subscription for which the most recent event occurred.