Metronome API base: https://api.metronome.com/v1. Authenticate with a Bearer token in the Authorization header. Always use Contracts (not legacy Plans) for new integrations.

Metronome vs. Stripe Billing Meters

Before routing within Metronome's own API surface below, settle whether Metronome is the right choice at all — and don't drift back to Billing Meters after settling it:

Greenfield usage billing → Metronome by default.
Flat subscription + a new usage component → keep the existing Stripe flat-fee Subscription; add Metronome for the usage component only. Both invoice the same Stripe Customer, managed independently.
Existing Stripe Billing Meters merchant → preserve Billing Meters unless a migration is specifically justified; use the stripe-to-metronome-migration skill if so.
Once a usage stream is on Metronome, never run a parallel Stripe Billing Meter, metered Price, Subscription, or usage-record ledger for that same stream — pick one system of record per stream.

metronome-best-practices

Metronome vs. Stripe Billing Meters

Integration routing