Customers

The Customers section manages the entities that subscribe to and consume your products. Aforo models a customer hierarchy that works across all four product types.

Customer Hierarchy

Customer (company / individual)
  └── Team (department / project)
        └── App / Agent (application or AI agent instance)
              └── API Key / Credentials (authentication tokens)

Creating a Customer

1. Go to Customer Success → Customers
2. Click + New Customer
3. Enter name and email
4. Optionally set the plan, default currency, legal name, VAT number, website, phone, and locale

Customer Deletion Guard

Aforo prevents deletion of customers with financial dependencies:

Check before deleting:

Teams

Teams represent organizational units within a customer account — a department, project, or cost center. Each team has its own budget tracking and can have multiple apps or agents.

Agents

For AI Agent and MCP Server products, customers register agents — autonomous AI systems that consume your APIs on behalf of the customer.

Agent fields:

• agentType — CLAUDE, GPT, LANGCHAIN, CREWAI, AUTOGEN, or CUSTOM
• team — which team owns this agent
• rateLimits — per-agent usage caps
• capabilities — declared capabilities for access control

Agents can be suspended or reactivated independently of the customer account.

Wallets

In PREPAID or HYBRID billing mode, each customer has a wallet that holds their credit balance. Wallets are currency-specific.

Wallet Operations

• Fund — Add credits (via payment or manual operator credit)
• Hold — Reserve funds for in-progress usage (released or committed at billing)
• View balance — Current spendable balance + pending holds

API Keys

API keys are tied to subscriptions, not directly to customers. When a customer subscribes:

1. A key is created and bound to the subscription
2. The key is presented once — store it securely
3. If the subscription is cancelled, all bound keys are automatically revoked

Credential Types