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

Next steps