Skip to main content
The Meter object stores usage quantities that drive usage-based billing or consumption tracking. It links customers, items, and subscriptions so you can record consumption and automate downstream invoicing or inventory actions.

​
What you can do with Meter

  • Capture usage history: log quantities and timestamps per customer and item.
  • Tie to subscriptions: attach meters to subscriptions to bill based on recorded usage.
  • Trigger actions: use actions to create inventory transactions or other workflows from usage data.
  • Import / export at scale: load usage via CSV or automation and keep data auditable.

​
Key default properties

  • Meter ID: auto-incremented number unique within the workspace.
  • Customer: links to a Company or Contact.
  • Item: the product whose usage you measure.
  • Subscription: optional link when usage-based billing applies.
  • Usage: numeric quantity (calls, hours, units, etc.).
  • Usage At: timestamp for when the usage occurred.
  • Status (usage_status): active or archived.
  • Created / Updated: audit timestamps.
  • Custom properties: add industry-specific fields as needed.

​
Basic workflow

  1. Create a meter record from Commerce > Meter, entering item, customer, usage quantity, and measurement time; link a subscription if billing depends on it.
  2. Update usage as consumption accrues, and toggle status to archive retired meters.
  3. Associate to subscriptions and run actions to generate invoices or inventory transactions from usage.
  4. Bulk load usage through CSV import/export or automation to keep data in sync with external systems.