referrals

Redeem Promo Code

Redeem a system-generated referral code.

Validates the code against the referral_codes table (case-insensitive), then grants RevenueCat premium for the duration configured on the code (week / month / year), stacking on top of any existing subscription. The grant is recorded in referral_grants.

Restrictions:

  • Code must exist in referral_codes and have status = 'active'
  • User cannot redeem the same code more than once (no limit on redeeming different codes)

Args: request: RedeemSystemCodeRequest with the code

Returns: RedeemSystemCodeResponse with success status and message

post/api/referrals/redeem-promo

Headers

x-user-idstring nullable

Request body

codestring required

The promo code to redeem

Response

Successful Response

successboolean required

Whether the redemption was successful

messagestring required

Success or error message

Changes

No recorded changes to this endpoint across all 8 revisions of this API.