GrowthRailDocs
Documentation

Build referrals that actually convert

Everything you need to build powerful referral and rewards programs into your application — from a 15-minute quick start to the full REST API.

Core Capabilities

Referral Tracking

Automated tracking of invitations and successful signups across multiple campaigns. Unique 6-character referral codes, cookie-based attribution, and deferred deep linking for mobile.

Dynamic Rewards

Grant rewards based on custom trigger events like signups, purchases, or KYC completion. Built-in eligibility checks prevent fraud and double-claiming.

Webhooks

Real-time delivery of reward events to your backend via signed webhooks. Automatic retries (5 attempts), delivery logs, and manual replay from the dashboard.

Multi-Project

Manage multiple apps or environments under one organization. Isolated data per project with separate secrets, users, campaigns, and webhooks.

Built-in UI

Drop-in referral sharing UI with floating trigger buttons, customizable modals/drawers, social sharing, and new-user promotional banners. Fully themeable.

SDK Support

First-party SDKs for React, React Native, iOS (Swift), Android (Kotlin), and vanilla JavaScript. Wrap your app in a provider (or native host) and get referral functionality with a few lines of code.

How It Works

Growth Rail handles the complete referral lifecycle in four steps:

User Shares
Existing user gets a unique referral link
Friend Clicks
SDK auto-detects and tracks the referral
Action Taken
Friend completes signup or qualifying event
Reward Sent
Webhook notifies your backend to credit the referrer