Update a subscription
Update the editable fields of a subscription. Only the allow-listed properties may be changed; any other field is ignored. billing_address replaces the subscription’s billing address (all of street, house number, zip, city are required); the address row is mutated in place, so a row shared across a customer’s subscriptions changes everywhere it is referenced. payment_method attaches a new SEPA direct-debit mandate to the subscription, replacing the current mandate. metadata is merged key-by-key onto the stored metadata (a key set to null is removed; metadata: null clears every key). Returns the updated subscription. From API version 2026-09-08.gauss, the body must be JSON without repeated keys.
Authorizations
Body
The subscription fields to update
Response
The updated subscription
ID of the household the subscription belongs to. A household groups the contracts at one metering point: one consumption subscription at a time, plus the feed-in subscriptions on that same meter. It belongs to one customer and stays the same when they cancel and sign up again. A separately metered device, such as a heat pump with its own meter and consumption subscription, is a household of its own, so one customer at one address can have two.
"dom_k2m9x4qpz7w1c8v3n6b5t0ry"