---
title: Customers
description: Manage customer entities and billing relationships
---

A customer is a billable entity: one person, or one organization. The customer owns the
subscriptions and pays for them. Billing and service management in the API are built around
this entity.

## Customer entity

A customer in the API represents:

- **Billable entity**: Individual person or organization responsible for payments
- **Service owner**: Entity that owns telecommunications subscriptions and licenses
- **Billing configuration**: Payment methods, billing cycles, and financial preferences
- **Contact information**: Communication details for service notifications and support

## Key capabilities

- **Customer lifecycle** — Create a customer, update it, and hold its profile and its billing configuration.
- **User management** — Add or remove users from customer accounts to manage access permissions and service administration.
- **Billing configuration** — Configure billing methods, payment preferences, and financial settings per customer.
- **Service ownership** — Track all subscriptions, licenses, and services owned by each customer entity.

## Common use cases

- **Customer onboarding** — Create new customer accounts with required billing and contact information during signup flows.
- **Account management** — Update customer profiles, billing preferences, and contact details through self-service portals.
- **Multi-user access** — Associate multiple users with business customers for shared service management and administration.
- **Billing administration** — Configure billing methods, payment schedules, and financial settings for automated revenue collection.

## Related resources

Customer entities are closely integrated with other API resources:

- **Users**: Platform access and permissions for customer account management
- **Subscriptions**: Telecommunications services owned by the customer
- **Orders**: Purchase requests and service provisioning for the customer
- **Payments**: Financial transactions and billing for customer services
- **Billing settings**: Configure billing methods, preferences, and payment automation per customer
- **Licenses**: Software licenses and digital services owned by the customer

## Next steps

- [List customers](/api-reference/customers.md#tag/customers/GET/customers) — Retrieve all customers you have access to
- [Create customer](/api-reference/customers.md#tag/customers/POST/customers) — Create a new customer account
- [Update customer](/api-reference/customers.md#tag/customers/PUT/customers/{customerId}) — Modify customer details and preferences