🧑‍💼Affiliate Management Dashboard

The affiliate management dashboard gives program admins full visibility and control over their affiliate base — from reviewing incoming applications to managing tiers, badges, and individual performance.

Access it at Affiliates → Dashboard in the Fuul app.

Affiliate list

View all active affiliates in your program with their performance metrics:

Metric	Description
Volume	Total action volume attributed to this affiliate
Revenue	Fees or revenue generated by their referred users
End users	Total unique users brought in
Earnings	Total payouts per currency
Tier / Audience	Which reward tier they currently qualify for

Tier details

Each affiliate's profile shows:

• Active tier — The effective tier after accounting for any protection period

• Current tier — The tier based on current metrics, before protection is applied

• Tier protection — Days remaining in the protection period (1–365)

• Protection — A badge showing where the protection stands, with the exact expiry date in the tooltip

Protection badge	Meaning
Protected (green)	Protection active, more than 30 days left
Expiring (yellow)	Protection active, 30 days or less left
Expired (red)	Protection lapsed within the last 7 days
—	No protection pinning the tier, or it lapsed more than 7 days ago

The badge only appears when the protection is actually holding the affiliate's tier. A protection still awaiting approval, or set to a tier below the one the affiliate already earns, shows no badge. When a protection expires the affiliate moves to the tier their audiences and metrics give them, which is not necessarily the default tier.

Filter by status (active / suspended), region, audience, or protection (multi-select). Multiselect filtering by specific conversions and audience IDs is also supported. The CSV export honors the protection filter.

Applications

When your program requires approval before affiliates can join, review and process incoming applications here.

Action	Description
Approve	Add the affiliate to a static audience (required)
Reject	Record a rejection reason
Hold	Keep for later review

Click any affiliate to view their referral tree, audience memberships, badges, status, and activity history.

Master Affiliates

A master affiliate manages a pool of sub-affiliates and earns a spread on each conversion they generate. Admins designate any existing affiliate as a master affiliate — a marketing agency is a common example.

Master affiliate list and detail responses include aggregated metrics:

Field	Description
sub_affiliates_count	Number of sub-affiliates bound to this master affiliate
referred_volume_usd	Combined L1 volume of the master's sub-affiliates (not the master's own volume)

Admin API endpoints (require Admin role):

Endpoint	Description
GET /api/v1/projects/:projectId/agencies	List all master affiliates with aggregated metrics
GET /api/v1/projects/:projectId/agencies/:agencyId	Master affiliate detail with per-currency earnings
GET /api/v1/projects/:projectId/agencies/:agencyId/sub-affiliates	Sub-affiliates with individual volume and earnings. Supports sort_by=referred_volume.

Admins can remove master status from an affiliate — this downgrades it back to a regular sub-affiliate while preserving all historical attribution and payout data.

Master affiliate payouts (agency_payout) are excluded from leaderboard rankings. Only affiliate_payout and end_user_payout movements count toward leaderboard position.

Audiences, tiers & badges

The dashboard shows each affiliate's audience memberships and badges. These features are not exclusive to affiliates — they apply to any user in the program.

• Audiences & Tiers — segment users and assign different reward rates → Tiers & Multipliers

• Badges — visual recognition for users based on audience membership → Badges

Approving an affiliate application automatically adds them to the audience you select during approval. This is the recommended way to onboard affiliates into a specific tier.