Referred Customers: what moves it
Referred Customers is the share of new Customers that a Customer, Partner or creator sent.
Referred Customers is the share of new Customers who arrived through a Referral from a Customer, a Partner or a creator.
The number
You, to your agent
What moved referred Customers this week, and which Play moved it?
curl "https://api.sb/leaseline.app/acquisitions?where=kind%20%3D%20%22referral%22%20and%20at%20%3E%3D%20%222026-09-21%22&facets=partner" \
-H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
curl -X POST https://api.sb/leaseline.app/metrics/query \
-H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"metric":"referral-share","shape":"trend","breakdown":"play","window":"28d"}'import { $ } from 'startup-builder'
const { facets } = await $.Acquisition.list({ where: 'kind = "referral" and at >= "2026-09-21"', facets: 'partner' }) // first touches a Customer,npx startup-builder do Acquisition.list --json '{"where":"kind = \"referral\" and at >= \"2026-09-21\"","facets":"partner"}'
npx startup-builder do Metric.query --json '{"metric":"referral-share","shape":"trend","breakdown":"play","window":"28d"}'{
"name": "do",
"arguments": {
"code": "const { facets } = await $.Acquisition.list({ where: 'kind = \"referral\" and at >= \"2026-09-21\"', facets: 'partner' }) // first touches a Customer, Partner or creator sent\nreturn await $.Metric.query({ metric: 'referral-share', shape: 'trend', breakdown: 'play', window: '28d' }) // by the Play credited"
}
}Response200
application/json{
"metric": {
"$id": "https:samplePreview4 % of new Customers referred · ■□□□ Too early to tell · n 24
$.Metric.query({ metric: · sample
| Credited to | This window | Customers |
|---|---|---|
| Warm intros | 4 % | 1 |
| Customer referrals | 0 % | 0 |
The hub defines it: referral-share. This page adds the Plays and seats that move it.
Owner
| Accountable | From |
|---|---|
team: · the hub’s Marketing team, as the reused id keeps it | the hub Metric, unchanged |
Worked by
| Title | Its queue |
|---|---|
| Partnerships | POST /{namespace}/tasks/next on the Partnerships’s queue |
Moved here by
| How | Where |
|---|---|
| Play | Champion follow · When a champion changes jobs, offers them their own setup, pre-loaded at the new company, 30 days in; the old company’s data never moves. |
| Play | Commission partners · Pays Customers and creators who send you buyers a share of what you collect, after refunds, and checks every payout first. |
| Play | Creator partnership · Moves creators who already answer your buyers’ questions up one ladder of Agreements, each rung paid on revenue they bring after refunds, never on views. |
| Play | Customer referrals · Asks Customers to invite a peer right after they get the result they came for, and rewards both once the peer’s first payment clears refunds. |
| Page | Reviews and referrals |
| Title | Partnerships |
The leaves
| Under it | Moved by |
|---|---|
champion-new-orgs | Champion follow |
creator-attributed-revenue | Creator partnership |
paid-referrals | Customer referrals |
partner-sourced-revenue | Commission partners |
Compiled, not written: edit the records it reads (metrics/bridge.ts; cap), then regenerate. Every step runs from a sentence or a line of code. In your words: the CRM words you know, and where each lives here.