---
title: "Changes to Crear Subscription"
method: POST
path: "/subscriptions"
---

# Changes to Crear Subscription

`POST /subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `a6ef070075b1`: 15 breaking, 15 warning, 36 info

## Changes

- **2026-11-03** `a6ef070075b1`: 15 breaking, 15 warning, 36 info
  - request body became required
  - for the `header` request parameter `x-account-key`, default value `` was added
  - added `#/components/schemas/CurrencyIso` to the `currency_code` request property `allOf` list
  - added `#/components/schemas/Frequency` to the `frequency` request property `allOf` list
  - removed the enum value `daily` of the request property `frequency`
  - removed the enum value `monthly` of the request property `frequency`
  - removed the enum value `weekly` of the request property `frequency`
  - removed the enum value `yearly` of the request property `frequency`
  - the `product_id` request property's minLength was increased from `0` to `1`
  - the `currency_code` request property type changed from `string` to no type
  - the `frequency` request property type changed from `string` to no type
  - the `metadata` request property type changed from `string` to `object`, and format from `json` to no format
  - the response's body type changed from no type to `object` for status `422`
  - the `amount` response's property type changed from `integer` to `number` for status `200`
  - the `amount` response's property type changed from `integer` to `number` for status `201`
  - the `amount` request property's exclusiveMaximum was set to `1000000000000000.00`
  - the `receipt_product_code` request property's maxLength was set to `8`
  - the `due_day` request property's max was set to `31.00`
  - the `interval` request property's max was set to `52.00`
  - the `amount` request property's min was set to `0.00`
  - the `creation_lead_days` request property's min was set to `0.00`
  - the `due_day` request property's min was set to `1.00`
  - the `interval` request property's min was set to `1.00`
  - the `max_active_invoices` request property's min was set to `1.00`
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `metadata/var1` from the response with the `200` status
  - removed the optional property `metadata/var1` from the response with the `201` status
  - removed the optional property `metadata/var2` from the response with the `200` status
  - removed the optional property `metadata/var2` from the response with the `201` status
  - api operation id `crear-subscription` removed and replaced with `create_or_update_subscription`
  - api tag `Subscriptions` added
  - added the new optional `header` request parameter `x-api-version`
  - the `amount` request property format was generalized from `float` to no format
  - the `due_day` request property format was generalized from `int32` to no format
  - removed `subschema #1, subschema #2: Exception - due_day` from the response body `oneOf` list for the response status `422`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - removed the non-success response with the status `409`
  - added the optional property `currency_code` to the response with the `200` status
  - …26 more

---

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