Referrals that drive growth
Generate unique referral links, track milestones, manage rewards, and display leaderboards. Everything you need to build a referral program without third-party tools.
Referral links are deep links
When a referrer shares their link, it goes through the Tolinku deep link engine. If the referred user needs to install, the deferred deep link carries the referral code through the install. The SDK automatically advances the milestone to "installed" on first open.
- Unique 10-character codes generated per referrer via REST API
- Configurable milestones: sign up, first purchase, 3 orders, or any custom string. With ecommerce tracking, milestones can auto-complete when a referred user makes a purchase.
- Auto-expiration of pending referrals (configurable, default 30 days)
- Per-user cap on active referrals to prevent abuse
Define your milestone pipeline and rewards
Configure your referral program entirely from the Appspace settings. Define an ordered milestone pipeline, pick which milestone triggers the reward, and choose a reward type. The platform stamps the reward on completion; your backend fulfills it via webhook.
- Ordered pipeline: Define milestones as a comma-separated list; the API validates each step in order
- Four reward types: points, credit, discount, or custom with a freeform value field
-
Reward claiming: Call
POST /api/referral/claim-rewardto mark rewards as fulfilled - Milestone history: Every step is timestamped and stored, shown as a visual timeline in the dashboard
Track every referral in real time
Your referral dashboard shows total, pending, completed, and expired counts at a glance with conversion rate calculated automatically. See a real-time feed of recent referrals, search by referrer or code, and filter by milestone status.
- Stat cards with period-over-period comparison (7d, 30d, 90d)
- Leaderboard ranking top referrers by completed count with total reward value
- Paginated list with search, filtering by status, and CSV export
-
Webhook events:
referral.createdandreferral.completedfire in real time
Integrate referrals into your app
Create referral codes, advance milestones, claim rewards, and fetch leaderboards with simple REST calls. The leaderboard API is available to your SDK, so you can build an in-app leaderboard and progress screen.
POST /v1/referral/create generates a unique code and shareable link
POST /v1/referral/advance moves a referral to the next milestone
POST /v1/referral/claim-reward marks the reward as fulfilled
GET /v1/referral/leaderboard returns top referrers for in-app display
// POST /v1/referral/create { "referrer_id": "user_sarah_j", "campaign": "summer-launch" } // Response { "code": "RF8kX2mN9p", "link": "https://yourapp.link/ref/RF8kX2mN9p", "milestone": "clicked", "status": "active" }
// POST /v1/referral/advance { "code": "RF8kX2mN9p", "milestone": "purchased" } // Response { "status": "completed", "reward": { "type": "credit", "value": "$10" } }
The referral lifecycle
From link creation to reward fulfillment, in three steps.
Create
Your app calls the API with the user ID. Tolinku generates a unique 10-character code and a shareable deep link.
POST /v1/referral/create
Track
The referred user clicks, installs, and hits milestones. Each step is tracked automatically through the deep link engine and SDK.
clicked > installed > signed_up
Reward
When the configured milestone is reached, the referral auto-completes. A webhook fires and your backend issues the reward.
referral.completed webhook
Create
Your app calls the API with the user ID. Tolinku generates a unique code and shareable link.
Track
The referred user clicks, installs, and hits milestones. Each step is tracked automatically.
Reward
When the milestone is reached, the referral completes and a webhook fires for your backend.
Launch your referral program
Enable referrals in your Appspace settings and start growing through word of mouth.