/Docs
/Customers
Customers
A customer in Floatless represents a billable entity — typically a company or individual who purchases your products or services.
When should I read this?
Read this if you need to understand how customers are structured, what data is stored, or how customers relate to other objects like subscriptions and invoices.
What is a customer?
A customer object holds:
- Contact information — name, email, phone
- Billing address — used for invoicing and tax calculation
- Tax settings — tax exempt status, tax ID
- Payment methods — connected via Stripe
- Metadata — custom fields for your internal use
Key relationships
| Related Object | Relationship |
|---|---|
| Subscriptions | A customer can have multiple active subscriptions |
| Invoices | All invoices are tied to a single customer |
| Payments | Payment history is tracked per customer |
| Credits | Account credits are applied at the customer level |
Common operations
- Create a customer — via dashboard or API
- Update billing info — address, tax settings
- View history — invoices, payments, subscriptions
- Apply credits — add account balance for future invoices