Docs & Help

Everything you need to ship referrals

Guides for platform admins, advertisers, and referrers.

Getting started

Create an account at /signup — that provisions your workspace, a starter campaign, and your first referral link automatically.

Three roles share one login: platform admins manage the whole platform, advertisers run campaigns in their workspace, and referrers share links and track earnings.

Use the demo logins (password Demo1234): super@aistudioreferrals.com, demo@nimbus.io, referrer@nimbus.io.

Creating campaigns

Go to Admin → Create program. Pick a trigger event (signup, first purchase, subscription, KYC, or a custom event) and an attribution model + window.

Set a referrer reward and an optional double-sided referee reward. Everything is config-driven — no code or redeploy needed to launch.

Run multiple campaigns at once, including A/B variants that share an A/B key and split traffic.

Rewards & payouts

Rewards can be cash, account credit, % or flat discounts, free months, points, or gifts — one-time or recurring, with milestone tiers for top referrers.

Rewards are held for a configurable period, screened for fraud, then cleared to the referrer wallet. Referrers request payouts from their dashboard.

Pick your workspace currency in Settings — all amounts format accordingly.

Inviting & managing referrers

Advertisers invite referrers from Admin → Referrers. Each invite creates a referral link and a portal login so the referrer can track their own performance.

Referrers can personalize their link (from their name or a custom unique code) and share via WhatsApp, X, LinkedIn, Telegram, email, SMS or QR.

Fraud protection blocks self-referrals, throttles velocity, flags disposable emails, and routes suspicious conversions to a manual review queue.

Integrations

Connect payouts (Stripe, PayPal, Razorpay, Wise, Tremendous), messaging (Resend/SendGrid, Twilio, Slack/Discord), e-commerce, CRM and analytics.

Platform admins manage the integration catalog from Platform → Integrations and can add entirely new providers with no code change.

Inbound and outbound webhooks let any system notify Ai Studio Referrals when a qualifying event happens.

API & widget

Generate an API key in Settings → API keys. Authenticate with `Authorization: Bearer <key>`.

Key endpoints: POST /api/referrals (get/create a link), POST /api/conversions (record a trigger event), GET /api/referrals (paginated list), POST /api/payouts.

Drop the embeddable widget into your app with one script tag — see /widget.js.

FAQ

Is there a free tier?

Yes — new workspaces start on a free plan with a trial of paid features.

Do referral links work in any casing?

Yes. Links are case-insensitive, so /r/SUMMER and /r/summer resolve to the same campaign.

Can I white-label it?

Advertisers set brand and accent colors (and a custom domain) in Settings; the referrer experience adopts them.

Still stuck?

Ask the community or reach support.