Referrals

Create referral and promo codes that reward both the referrer and the referee with virtual currency.

How it works

1. Admin creates a referral code with rewards for both parties
2. User shares their referral code
3. When the code is redeemed, both users receive their rewards
4. Usage is tracked with claim counts and optional limits

MCP tools

Example

Agent: "Create a referral program that gives 100 gold to both users"

amba_referrals_create({
  project_id: "proj_xxx",
  code: "FRIEND100",
  reward_referrer: { "gold": 100 },
  reward_referee: { "gold": 100 },
  max_uses: 1000
})

Client API reference

Claim a referral code

POST /client/referrals/claim
{
  "code": "FRIEND100"
}