list_partner_referrals
List the creators the token's creator brought to Subscriby as a partner — how each arrived, whether their first paid invoice converted them and until when the partner earns on them. Read-only.
Page the creators the partner brought in, newest first, in the shape GET /v1/me/partner/referrals
answers. status is typed first, so an unknown word is a VALIDATION_FAILED rather than an empty
page. Each row names the referred creator by display name alone: they are a Subscriby customer,
not the partner's, so their email and id never appear.
Read-only. Never mutates anything.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
statusstringoptionalOptional filter: "signed_up", "converted", "under_review", "expired" or "rejected".
limitintegeroptionalMaximum referrals to return per page (1..100).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "3c4d5e6f-7081-4a2b-9c3d-4e5f6a7b8c9d", "referred_name": "Grace Hopper", "source": "link", "status": "converted", "plan": "starter", "signed_up_at": "2026-10-08T11:00:00+00:00", "expires_at": "2027-04-06T11:00:00+00:00", "converted_at": "2026-10-09T14:20:00+00:00", "commission_percent": "15.00", "commission_ends_at": "2027-10-09T14:20:00+00:00", "created_at": "2026-10-08T11:00:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}source is link (the web link's cookie), code_at_signup (the code typed on the sign-up form)
or bot_deep_link. status is signed_up (inside the conversion window, no paid plan yet),
converted (first Starter or Growth invoice paid, earning), under_review (held by Subscriby for a
fraud signal), expired or rejected. commission_percent is the rate locked onto the referral
at conversion and commission_ends_at when the partner stops earning on them.
An application under review has no referrals
The tool answers an empty page, not an error, while the partner's
application is still being reviewed; only a creator who never applied is
RESOURCE_NOT_FOUND.
How it fails
VALIDATION_FAILEDstatus is not one of signed_up, converted, under_review, expired, rejected.
RESOURCE_NOT_FOUNDthe creator never applied to the programme.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
How is this guide?
Last updated on
list_partner_payouts
List the cash payouts Subscriby made to the token's creator as a partner — the amount, the rail, the transfer's reference and how many commissions each covered. Read-only.
list_partner_rewards
List the token's creator's Partner Program commission ledger — one row per paid invoice of a referred creator, plus the clawbacks, each with its state from held to settled or reversed. Read-only.