---
title: "Changes to Create a subscription"
method: POST
path: "/subscriptions"
---

# Changes to Create a subscription

`POST /subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `ae823aac7088`: 3 warning, 73 info

## Changes

- **2026-11-03** `ae823aac7088`: 3 warning, 73 info
  - removed the optional property `errors` from the response with the `401` status
  - removed the optional property `errors` from the response with the `403` status
  - removed the optional property `errors` from the response with the `500` status
  - added the new optional request property `change_reason`
  - the `address/city` request property's minLength was decreased from `2` to `1`
  - the `address/street` request property's minLength was decreased from `2` to `1`
  - removed the pattern `[a-zA-Z\u00E4\u00F6\u00FC\u00DF\u00C4\u00D6\u00DC]` from the request property `address/street`
  - removed the pattern `^[A-Za-z0-9\-/\s]+$` from the request property `address/house_number`
  - removed the pattern `^[^\d]*$` from the request property `address/city`
  - removed the pattern `^\d+$` from the request property `address/zip`
  - removed the non-success response with the status `402`
  - removed the non-success response with the status `405`
  - removed the non-success response with the status `409`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `429`
  - removed the `custom` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `custom` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `duplicate_customer_email` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `duplicate_customer_email` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `duplicate_grid_reduction` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `duplicate_grid_reduction` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `duplicate_meter_order` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `duplicate_meter_order` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `duplicate_meter_reading` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `duplicate_meter_reading` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `ended_subscription` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `ended_subscription` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `implausible_meter_reading` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `implausible_meter_reading` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_element` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `invalid_element` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_format` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `invalid_format` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_iban` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `invalid_iban` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_key` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `invalid_key` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_termination_date` enum value from the `errors/items/code` response property for the response status `400`
  - removed the `invalid_termination_date` enum value from the `errors/items/code` response property for the response status `404`
  - removed the `invalid_type` enum value from the `errors/items/code` response property for the response status `400`
  - …36 more

---

[Operation](https://skmtc.dev/nomos/apis/nomos-api/docs/subscriptions/post.md) - [API](https://skmtc.dev/nomos/apis/nomos-api.md) - [Page](https://skmtc.dev/nomos/apis/nomos-api/changes/subscriptions/post)
