Loyalty & Rewards

Klaviyo integration

Syncs points balance, lifetime points, VIP tier, perks, and referral URL to Klaviyo profiles (like Smile.io).

Enable Klaviyo syncKlaviyo private API key

List ID (optional)

Subscribe profiles to this list on sync

Staff can redeem rewards in-store from the POS page or via API with the POS key header.

Enable POS redemptionPOS API key

Used by /pos page and X-Pos-Api-Key header

Smile-style reminders shown as banners on the storefront (near reward, VIP progress, birthday, welcome back).

Enable nudges

near reward

Title

Threshold %

Show when progress exceeds this percent

Message

Use {balance}, {pointsName}, {nextTier}, {pointsAway}

tier progress

Title

Threshold %

Show when progress exceeds this percent

Message

Use {balance}, {pointsName}, {nextTier}, {pointsAway}

birthday

Title

Message

Use {balance}, {pointsName}, {nextTier}, {pointsAway}

welcome back

Title

Message

Use {balance}, {pointsName}, {nextTier}, {pointsAway}

Schedule POST /api/cron/expire to run periodically.

Expire inactive pointsMonths of inactivity

Reward code validity (days)

Unused redemption codes expire after this many daysReward expiry reminder (days before)