Introduction
Everything you need to implement and manage in-app referrals with Invitebase.
Invitebase is the referral layer for consumer apps: one SDK across iOS, Android, and web that lets your users invite friends, attributes every signup back to the person who shared, and pays rewards only when the referral is real. You define what counts as a referral, Invitebase handles attribution, validation, fraud, and payouts.
SDKs are available for iOS, Android, Web, React Native, and Flutter — or call the REST API directly from any stack.
The core loop is four calls and can be configured in as little as five minutes:
import invitebase from '@invitebase/js';
invitebase.configure('pk_test_...'); // start an anonymous-first session
invitebase.identify({ id: 'usr_123' }); // alias it to your user at signup
const link = await invitebase.getReferralLink('7e1f8a3b-4c26-49d0-b591-0d8e2f6a3c15'); // their share link
invitebase.track('subscription_started', { plan: 'paid' }); // events your gates evaluateimport InvitebaseSDK
Invitebase.configure(key: "pk_test_...") // start an anonymous-first session
Invitebase.identify(user: .init(id: "usr_123")) // alias it to your user at signup
let link = try await Invitebase.getReferralLink(campaignId: "7e1f8a3b-4c26-49d0-b591-0d8e2f6a3c15") // their share link
Invitebase.track("subscription_started", properties: ["plan": "paid"]) // events your gates evaluateimport com.invitebase.sdk.Invitebase
Invitebase.configure(context, key = "pk_test_...") // start an anonymous-first session
Invitebase.identify(User(id = "usr_123")) // alias it to your user at signup
val link = Invitebase.getReferralLink(campaignId = "7e1f8a3b-4c26-49d0-b591-0d8e2f6a3c15") // their share link
Invitebase.track("subscription_started", mapOf("plan" to "paid")) // events your gates evaluateimport { InvitebaseProvider, Invitebase } from '@invitebase/react-native';
// <InvitebaseProvider publishableKey="pk_test_..."> calls configure and starts the session
await Invitebase.identify({ id: 'usr_123' }); // alias it to your user at signup
const link = await Invitebase.getReferralLink('7e1f8a3b-4c26-49d0-b591-0d8e2f6a3c15'); // their share link
Invitebase.track('subscription_started', { plan: 'paid' }); // events your gates evaluateimport 'package:invitebase_flutter/invitebase_flutter.dart';
await Invitebase.configure('pk_test_...'); // start an anonymous-first session
await Invitebase.identify(InvitebaseUser(id: 'usr_123')); // alias it to your user at signup
final link = await Invitebase.getReferralLink('7e1f8a3b-4c26-49d0-b591-0d8e2f6a3c15'); // their share link
Invitebase.track('subscription_started', {'plan': 'paid'}); // events your gates evaluatePrefer no SDK? The REST API drives the same loop from any stack.
Risk-free to start — no credit card required
Accounts start in test mode with their own keys — free, never billed. It stays free for your first 100 validated referrals every month.
Set up Invitebase in four steps
New to Invitebase? This is the whole path, in order — all in test mode, so nothing is billed and no real money moves. The first three steps are dashboard work with no code; the fourth is where engineering wires it into your app.
Create your organization and first app, grab your test keys, and invite your team.
2Choose your rewardsNo code~5 minDecide what each side earns and pick a reward family — app grants or money. A product decision.
3Design your referral pagesNo code~5 minTheme the offer page, status page, and emails your users see, with a live preview.
4Integrate your appCode~10 minWire the SDK in and take a referral from signup to a validated test reward.
Want to see working code first? Skip ahead to Integrate your app — the loop runs in test mode before you finalize rewards or pages.
Or jump straight to
Install with AI
Paste one prompt into your coding agent and let it wire up the SDK for you.
Core concepts
Campaigns, qualification gates, linked vs. validated, rewards, and test mode.
SDK reference
The full shared surface for Web, iOS, Android, React Native, and Flutter.
API reference
Every REST endpoint, request and response shape, and error code.
Questions at any point: support@invitebase.com.