---
title: "Start a referral program"
description: "From signing in to a working referral program in the dashboard, one screen at a time."
canonical: "https://boltclaw.ai/docs/referral-start"
last-updated: "2026-11-05"
---

# Start a referral program

From signing in to a working referral program in the dashboard, one screen at a time.

This page takes you from signing in to a referral program that records a test sale,
in the dashboard, one screen at a time. Nothing here needs code until step 6, and
everything you choose stays editable afterwards. If you are an AI agent helping
somebody in their own browser, [the dashboard, screen by screen](https://boltclaw.ai/docs/dashboard)
has every screen's address.

## 1. Sign in

Open [Sign in](https://boltclaw.ai/auth/signin) and continue with Google, or with
an email address and a password (you confirm the address from an email first). A
new account gets its own organisation straight away, where your programs, team,
plan and keys live: there is nothing to set up and nothing to approve.
[Organisations and the API's workspace](https://boltclaw.ai/docs/authentication#organisations-and-the-apis-workspace)
says what that means for keys.

![The Bolt Claw sign-in page, with Continue with Google at the top and the email and password form below it.](https://boltclaw.ai/docs/screens/referral-start/01-sign-in.png)

## 2. Open Programs and press New program

In the sidebar, open **Referrals**, then **Programs**
([Referrals, Programs](https://boltclaw.ai/dashboard/referrals)). Press
**New program** at the top right. The meters beside it show your plan's
programs, approved partners and clicks.

![The Programs screen with no program yet, showing the plan's meters and the New program button at the top right.](https://boltclaw.ai/docs/screens/referral-start/02-programs.png)

## 3. Pick the kind of program

The kind decides the reward rules and settings the program starts with, and the
word the screens use for the people who share it. Every feature is on whichever
you pick, and each card says whether its starting reward is cash.

| If you are | Pick | It starts with |
|---|---|---|
| A product whose own users invite friends from inside it | **Refer a friend** | [One free month each after the friend's first payment, no cash](https://boltclaw.ai/docs/rewards#template-refer-a-friend) |
| Software with partners and affiliates who earn on payments | **Software affiliates** | [30% for 12 months](https://boltclaw.ai/docs/rewards#template-affiliate) |
| Working with creators who share a link and a code | **Creators and influencers** | [20% for 12 months, codes](https://boltclaw.ai/docs/rewards#template-creator) |
| Rewarding fans who unlock bonuses | **Ambassadors** | [A flat reward and a bonus](https://boltclaw.ai/docs/rewards#template-ambassador) |
| Working with resellers and agencies | **Resellers and agencies** | [Three levels](https://boltclaw.ai/docs/rewards#template-reseller) |
| An online shop | **Shops** | [10% of the first order](https://boltclaw.ai/docs/rewards#template-shop) |
| Launching, with a waitlist people move up | **Waitlist and launch** | [Early access by friends](https://boltclaw.ai/docs/rewards#template-waitlist) |
| Anything else | **Start from scratch** | [No reward rules: you add your own](https://boltclaw.ai/docs/rewards#template-scratch) |

The links open [what each kind sets](https://boltclaw.ai/docs/rewards#a-template-for-each-kind-of-business),
generated from the templates themselves. With **Refer a friend**, your own users
are referrers: you can try one in test mode without touching live data
([a test referrer](https://boltclaw.ai/docs/testing#your-own-users-in-test-mode)). Before **Create
program**, Refer a friend asks one more question: **When does the friend get their
month?** **After their first payment** (the default) gives nothing until a payment
clears the hold, takes it back on a refund and lets every fraud check apply. **At
checkout, as a discount** is free product before any payment, which Bolt Claw can
only check if your checkout asks first; see
[at checkout or after a payment](https://boltclaw.ai/docs/rewards-not-cash#friend-reward-shapes).

![The New program dialog asking what kind of program it is, with a card for each kind and Start from scratch last.](https://boltclaw.ai/docs/screens/referral-start/03-kind.png)

## 4. Two questions, then the name, the product link and the currency

Two optional questions come next: how you take payments and how people sign up.
Your answers only shape the setup steps the program shows you, and you can skip
them or change them later.

![The two optional questions, how you take payments and how people sign up, with Skip and Next buttons.](https://boltclaw.ai/docs/screens/referral-start/04-questions.png)

Then give the program a **name**, the **product link** a partner's link sends people
to (it must start with https://), and the **currency** rewards and payouts are in. The
box at the bottom lists the rules and settings it starts with. Press
**Create program**.

![The last step of New program: name, product link and currency, and a box listing the rules and settings the program starts with.](https://boltclaw.ai/docs/screens/referral-start/05-details.png)

## 5. The program's page

The program opens on its own page, with five tabs:

- **Overview**: clicks, signups, sales and what you owe, and the review queue.
- **Partners**: who joined and who is waiting; for Refer a friend, your referrers too.
- **Payouts**: commissions, what is ready to pay, payouts and grants.
- **Rewards**: the reward rules, groups and levels, and what a friend is told.
- **Settings**: the program itself, and **Integration**, where the setup is.

To come back to any of them later, open the program from Programs, or follow
[Settings, Integration](https://boltclaw.ai/dashboard/referrals?open=integration):
with one program it opens that program's Integration section, with several it asks
which.

![A new program's page: its name, Pause and Archive, its five tabs (Overview, Partners, Payouts, Rewards and Settings) and its first figures on Overview.](https://boltclaw.ai/docs/screens/referral-start/06-program.png)

Open **Settings**, **Integration**. The setup status at the top has a row for each
part (the website tag, billing, signups, sales), each saying what is missing and
how to fix it. Below it, pick the billing system you take payments with: each card
says what to paste where. [Connecting billing](https://boltclaw.ai/docs/referral-setup) has every
system.

![The Integration section: the live setup status, with a row for each part of the setup and the fix for each.](https://boltclaw.ai/docs/screens/referral-start/07-integration.png)

## 6. A key for your server, limited to this program

If your own server reports signups and sales, or shows your users their referral
panel, it needs an API key. Open
[Settings, Developers, Create key](https://boltclaw.ai/settings/developers?new=key&preset=in-app-server)
(that link ticks the **In-app referrals server** preset), name the key, and under
**Which programs** pick this program only, so the key can neither read nor change
any other program ([Limit a key to some programs](https://boltclaw.ai/docs/authentication#limit-a-key-to-some-programs)).
[What each part of an integration needs](https://boltclaw.ai/docs/authentication#what-each-part-of-an-integration-needs)
says which preset fits which job. The key is shown once: store it on your server.

![The Create key form with the In-app referrals server preset ticked and the key limited to one program.](https://boltclaw.ai/docs/screens/referral-start/08-key.png)

Then, back on **Settings**, **Integration**, press **Send a test sale**. It runs
the whole path with test data: a click, a signup, a sale and a commission you can
see, none of it counted, paid or emailed. For a Refer a friend program, also make
a test referrer and send a test sale with their code
([Your own users, in test mode](https://boltclaw.ai/docs/testing#your-own-users-in-test-mode)).

![The Send a test sale panel after a run: a test partner's link, a click, a signup, a sale with its reward and a partial refund, each marked Test.](https://boltclaw.ai/docs/screens/referral-start/09-test-sale.png)

**Live** means real events from your billing system or your server, without
`test`. Test data never counts toward a payout, a limit or a report, and
**Clear test data** deletes it ([Test data](https://boltclaw.ai/docs/referral-setup#test-data)).

## 7. Where to go next

- The quickstart for your stack: [Next.js](https://boltclaw.ai/docs/referral-quickstart-nextjs),
  [Supabase](https://boltclaw.ai/docs/referral-quickstart-supabase), [Express](https://boltclaw.ai/docs/referral-quickstart-express)
  and the rest under "Referrals: your stack".
- [The referral panel](https://boltclaw.ai/docs/referral-panel), to show your own users their link
  inside your product.
- [The friend's welcome](https://boltclaw.ai/docs/referral-welcome): what a friend who arrives through
  a link is told.
- [Rewards that are not cash](https://boltclaw.ai/docs/rewards-not-cash): credit, free months and perks.
- [Safeguards and timing](https://boltclaw.ai/docs/referral-safeguards): what Bolt Claw guards by itself, and
  every hold and window with the value to choose, also on the program's
  [**Settings**, **Timing**](https://boltclaw.ai/dashboard/referrals?open=timing) section.
- [Limit a webhook endpoint to some programs](https://boltclaw.ai/docs/webhooks#limit-an-endpoint-to-some-programs),
  so one product's system hears only its own program's events.
- [Organisations and the API's workspace](https://boltclaw.ai/docs/authentication#organisations-and-the-apis-workspace),
  for two products: two programs, each with its own key.

<!-- https://boltclaw.ai/docs/referral-start as markdown. Generated from openapi.yaml; API version 1.53.0. -->
<!-- Every /docs page answers as markdown: add .md to its path, or send Accept: text/markdown. -->
