Create a subscription
Create a new subscription. The plan’s direction decides which signup rules apply.
Consumption plans:
meter.typemay besmartoranalogcustomer.vat_idis optionalintended_start_datemay be any future date; a date in the past is corrected to the next possible date, and when omitted, the next possible start date is usedprevious_suppliermay be set to cancel the customer’s existing contractproduct_ordersmay order a smart meter or §14a EnWG grid fee reductions, if the plan supports them
Feed-in plans:
meter.typemust besmart: a smart meter has to be installed before the signupcustomer.vat_idis required whencustomer.typeiscompany, optional for personsintended_start_datemust be the first day of a month, at least one month in the future; when omitted, the next possible production start date is usedprevious_supplieris not required for previous EEG customers.product_ordersare not supported: §14a EnWG does not apply to feed-in, and the smart meter must already be present
Requests that break one of these rules are rejected with 400 BAD_REQUEST and a message naming the violated rule.
From API version 2026-09-08.gauss, the body must be JSON without repeated keys, an unknown field is rejected with 400 BAD_REQUEST instead of being ignored, and next_possible_start: false requires intended_start_date.
Authorizations
Body
The subscription to create
Why the customer signs up at this address: switching supplier at an address they already live at, or moving in. A move-in is registered with the grid operator as such and no cancellation is sent to a supplier found at the address.
supplier_change, move_in "supplier_change"
Array of additional product orders. Each item has a 'type' and may include an additional object with the same name as the type for its details. Only supported for consumption plans: §14a EnWG does not apply to feed-in, and feed-in requires a smart meter before signup. From API version 2026-09-08.gauss, ordering the same product twice is rejected with 400.
Response
The created subscription details
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"