Referrals

The referral system lets your users invite others to your app and earn rewards. Tolinku handles the referral links, attribution, milestone tracking, and leaderboard. You configure the reward rules; your app calls the API to create referrals and report milestones.

How it works

1. A user in your app requests a referral code (your app calls the Tolinku API).
2. Tolinku generates a unique code and a referral link: https://your-app.tolinku.com/ref/ABC1234567.
3. The user shares the link with friends.
4. When a friend taps the link and installs the app, your app reports the referral completion to Tolinku.
5. Tolinku tracks the referral, updates the leaderboard, and fires a webhook so you can grant rewards.

Referral link format

Every referral link follows this pattern:

https://your-app.tolinku.com/ref/{referral_code}

The referral code is a random 10-character string (e.g. ABC1234567). It is unique across your Appspace.

Referral statuses

Status	Meaning
Pending	The referral link has been created but the referred user has not completed the required action yet.
Completed	The referred user reached the reward milestone. The referrer is eligible for a reward.
Expired	The referral was not completed within the expiration window.

Note

Referral tracking requires the Tolinku SDK or direct API calls from your app. The dashboard shows referral data, but your app is responsible for creating referrals and reporting milestones.

Next steps

Referral Setup Enable referrals and configure reward rules.

Referral Links How referral links are generated and shared.

Leaderboard Track top referrers and export rankings.

Rewards & Attribution Configure milestones, rewards, and expiration.