Referrals and Benefits
TokST referrals reward product benefits, not cash. Every account has one referral code and a shareable link in Dashboard → Settings → My referrals.
How a Referral Qualifies
- A new account registers through
https://tokst.com/ref/<code>. - The account confirms its email address.
- Within seven days of registration, the account creates one valid active memory through the dashboard, CLI, MCP, or REST API.
The inviter and the new account each receive one month of Pro benefits. Rewards have no monthly cap. Existing accounts cannot add or change a referral code, and self-referrals are excluded.
My Benefits
Referral rewards appear in Dashboard → Settings → My benefits as available Pro benefits.
- Free and Starter accounts can activate one available benefit at a time. It starts immediately, or is scheduled after an already active Pro benefit.
- Pro and Max accounts retain their current subscription. Activated rewards become renewal credit for a later paid renewal cycle.
- One Pro month is 30 days. Available benefits do not expire. Active and scheduled benefits show their start and end dates.
The dashboard always displays both the base plan and the currently effective plan. When an active Pro benefit expires, the account returns to its base plan.
Public Beta Membership
The referral-and-benefits migration grants every cloud account that already exists when it runs a public beta membership:
- Free, Starter, and Pro accounts receive active Pro access for 365 days from the migration date.
- Max accounts retain Max and receive 12 months of Pro renewal credit.
REST API
Authenticated clients can read the same account data through the cloud API:
| Method | Endpoint | Purpose |
|---|---|---|
GET | /v1/referrals/me | Referral code, statistics, and referral records |
GET | /v1/benefits/me | Benefit ledger, base plan, and effective plan |
POST | /v1/benefits/:id/activate | Activate one available Pro benefit |
CLI and MCP do not require referral commands. Their valid memory writes participate in activation automatically.