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 Commercial → Customers
2. Click + New Customer
3. Enter name, email, and external ID (optional — for linking to your CRM)
4. Set the customer's default currency

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