URL: /revenue/referral-share · Id: `page:/revenue/referral-share`

# Referred Customers: what moves it

> Referred Customers is the share of new Customers that a Customer, Partner or creator sent.

Referred [Customers](https://startupbuilder.dev/business/nouns/customer) is the share of new Customers who arrived through a [Referral](https://startupbuilder.dev/business/nouns/referral) from a Customer, a [Partner](https://startupbuilder.dev/business/nouns/partner) or a creator.

## The number

```text title="Referred Customers · Ask"
What moved referred Customers this week, and which Play moved it?
```

```ts title="Referred Customers · SDK"
import { $ } from 'startup-builder'

const { facets } = await $.Acquisition.list({ where: 'kind = "referral" and at >= "2026-09-21"', facets: 'partner' })   // first touches a Customer, Partner or creator sent
return await $.Metric.query({ metric: 'referral-share', shape: 'trend', breakdown: 'play', window: '28d' })   // by the Play credited
```

```json title="Referred Customers · Response · sample"
{
  "metric": {
    "$id": "https://api.sb/leaseline.app/metrics/referral-share",
    "$type": "Metric",
    "name": "Referral share"
  },
  "window": "28d",
  "value": 4,
  "unit": "percent",
  "rows": [
    {
      "play": "warm-intros",
      "value": 4,
      "customers": 1
    },
    {
      "play": "customer-referrals",
      "value": 0,
      "customers": 0
    }
  ]
}
```

`4 % of new Customers referred · ■□□□ Too early to tell · n 24`

`$.Metric.query({ metric: 'referral-share', shape: 'trend', breakdown: 'play', window: '28d' })` · sample

| Credited to | This window | Customers |
| --- | --- | --- |
| [Warm intros](/plays/warm-intros) | `4 %` | `1` |
| [Customer referrals](/plays/customer-referrals) | `0 %` | `0` |

The hub defines it: [`referral-share`](https://startupbuilder.dev/agents/marketing#referral-share). This page adds the Plays and seats that move it.

## Owner
| Accountable | From |
| --- | --- |
| [`team:marketing`](https://startupbuilder.dev/agents/marketing) · the hub’s Marketing team, as the reused id keeps it | the hub Metric, unchanged |

## Worked by
| Title | Its queue |
| --- | --- |
| [Partnerships](/capabilities/how-your-agents-act#partnerships) | <Op verb="Task.next" /> on the Partnerships’s queue |

## Moved here by
| How | Where |
| --- | --- |
| Play | [Champion follow](/plays/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](/plays/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](/plays/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](/plays/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](/revenue/reviews-references-referrals) |
| Title | [Partnerships](/capabilities/how-your-agents-act#partnerships) |

## The leaves
| Under it | Moved by |
| --- | --- |
| `champion-new-orgs` | [Champion follow](/plays/champion-follow) |
| `creator-attributed-revenue` | [Creator partnership](/plays/creator-partnership) |
| `paid-referrals` | [Customer referrals](/plays/customer-referrals) |
| `partner-sourced-revenue` | [Commission partners](/plays/commission-partners) |