Affonso - Affiliate Marketing Software

Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program settings. Use when the user asks about affiliate management, referral tracking, commission handling, or payout processing.

Affonso CLI Skill

Manage affiliate marketing programs from the command line.

Authentication

Use the AFFONSO_API_KEY environment variable. Verify with:

bash

affonso whoami --json

Never use affonso login — it requires a browser and won't work in headless environments.

Rules

• Always use --json on every command — without it, the CLI outputs ANSI tables that can't be parsed.
• Never delete without user confirmation — all delete operations are destructive and irreversible.
• Pagination — referrals use cursor-based pagination (--starting-after, --ending-before); all other resources use page-based (--page, --limit).

Commands

Command	Description
affiliates	List, get, create, update, delete affiliates
referrals	List, get, create, update, delete referrals (cursor-based pagination)
commissions	List, get, create, update, delete commissions
payouts	List, get, update payouts (no create/delete)
coupons	List, get, create, delete coupons (no update)
clicks	Create click events with UTM and sub-tracking
embed-tokens	Create embed tokens for partner portals
program	Get/update program settings + 8 sub-resources
marketplace	Browse/search public programs (no auth required)
config	Get/set CLI config (api-key, base-url)
whoami	Show authentication status

For full command details and options, see references/COMMAND_REFERENCE.md. For program sub-resources (payment-terms, tracking, restrictions, fraud-rules, portal, notifications, groups, creatives), see references/PROGRAM_SETTINGS_GUIDE.md.

Quick Start

1. Verify auth: affonso whoami --json
2. List resources: affonso affiliates list --json --limit 5
3. Take action: approve, create, update, or configure as needed

For multi-step workflow recipes, see references/WORKFLOWS.md.