ChargebeeAPI

Personalized offers

A Personalized Offer represents the best possible offer for a subscriber at a given moment in their lifecycle. It is generated by combining subscriber profile, subscription details, and contextual signals with the plays configured by Growth Managers in the Chargebee Growth dashboard. Learn more about Growth Solutions. Growth Managers define strategic plays that guide customer engagement. Developers then use the Personalized Offers API to fetch and surface these offers within the subscriber experience; whether in an app, portal, checkout flow, websites or communications like email and SMS. Some common plays include:

  • Acquire: Incentivize trial users or prospects to subscribe.
  • Expand: Encourage existing subscribers to purchase higher-value products or add-ons.
  • Retain: Engage at-risk subscribers with targeted winbacks or discounts.

Note: Growth solutions are currently in Early Access and available only for Chargebee Billing customers at no additional cost during the EAP period. This API is also part of the Early Access Program (EAP). To request access, go to the Chargebee Growth Early Access page in Chargebee Billing.

Features of this object

The Personalized Offers object enables you to:

  • Fetch context-aware offers generated by the Growth system.
  • Display offer content (title and description) to subscribers.
  • Provide subscribers with options they can act on.
  • Attribute offers to the correct brand (for multi-brand merchants).
  • Respect time-bound validity with the expires_at attribute.

Sample Personalized offerJSON

API Index URL

https://[site].chargebee.com/api/v2/personalized_offers

Personalized offers attributes

id
required, string, max chars=50

A unique and immutable identifier for the personalized offer.

offer_id
required, string, max chars=50

ID of the base offer configured. This ID is immutable and always refers to the core offer and its latest published version.

content

The offer content to display to the user, includes title & description.

options

List of offer options (choices or call-to-action buttons) in this offer.