--- title: "Changes to Create tier" method: POST path: "/v2/loyalties/tier-structures/{tierStructureId}/tiers" --- # Changes to Create tier `POST /v2/loyalties/tier-structures/{tierStructureId}/tiers` > Every recorded change to this operation, newest first. ## Timeline Changed in 16 of 211 revisions. - **2026-10-14** (v2) `d29b33490051`: 9 breaking, 1 warning, 1 info - **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 10 info - **2026-10-14** (v2) `6a418ac8b7b1`: 9 breaking, 1 warning, 1 info - **2026-10-14** (v2) `ec801ade260d`: 9 breaking, 6 warning, 1 info - **2026-10-13** (v2) `f95b50556c93`: 3 breaking, 1 warning, 12 info - **2026-10-13** (v2) `9905dfce1d1e`: 9 breaking, 6 warning, 1 info - **2026-10-13** (v2) `c59a345c733b`: 3 breaking, 1 warning, 12 info - **2026-10-13** (v2) `4d4d694f1847`: 9 breaking, 6 warning, 1 info - **2026-10-13** (v2) `84ad572f8dcb`: 3 breaking, 1 warning, 12 info - **2026-10-13** (v2) `58624588b18c`: 9 breaking, 6 warning, 1 info - **2026-10-13** (v2) `100ea5942966`: 3 breaking, 1 warning, 12 info - **2026-10-13** (v2) `ed683aacf90a`: 9 breaking, 6 warning, 1 info - **2026-10-07** (v2) `338a5e34004e`: 2 info - **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info - **2026-07-17** (v2) `26ef7b3dd1ef`: 1 breaking, 1 warning ## Changes - **2026-10-14** (v2) `d29b33490051`: 9 breaking, 1 warning, 1 info - the `allOf[#/components/schemas/Tier]/` response's property type changed from `object` to no type for status `200` - removed the required property `allOf[#/components/schemas/Tier]/created_at` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/downgrade` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/id` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/metadata` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/name` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/object` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/tier_structure_id` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/updated_at` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/Tier]/qualification_rules` from the response with the `200` status - added `#/components/schemas/TierMetadataBase, subschema #2` to the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200` - **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 10 info - the `allOf[#/components/schemas/Tier]/` response's property type changed from no type to `object` for status `200` - added the optional property `allOf[#/components/schemas/Tier]/qualification_rules` to the response with the `200` status - removed `#/components/schemas/TierMetadataBase, subschema #2` from the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200` - added the required property `allOf[#/components/schemas/Tier]/created_at` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/downgrade` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/id` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/metadata` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/name` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/object` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/tier_structure_id` to the response with the `200` status - added the required property `allOf[#/components/schemas/Tier]/updated_at` to the response with the `200` status - **2026-10-14** (v2) `6a418ac8b7b1`: 9 breaking, 1 warning, 1 info - the `allOf[#/components/schemas/Tier]/` response's property type changed from `object` to no type for status `200` - removed the required property `allOf[#/components/schemas/Tier]/created_at` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/downgrade` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/id` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/metadata` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/name` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/object` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/tier_structure_id` from the response with the `200` status - removed the required property `allOf[#/components/schemas/Tier]/updated_at` from the response with the `200` status - removed the optional property `allOf[#/components/schemas/Tier]/qualification_rules` from the response with the `200` status - added `#/components/schemas/TierMetadataBase, subschema #2` to the `allOf[#/components/schemas/Tier]/` response property `allOf` list for the response status `200` - **2026-10-14** (v2) `ec801ade260d`: 9 breaking, 6 warning, 1 info - added `#/components/schemas/TierCreateRequest` to the request body `allOf` list - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `tier_structure_id` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `tierStructureId` - removed the request property `downgrade` - removed the request property `metadata` - removed the request property `name` - removed the request property `qualification_rules` - removed the optional property `qualification_rules` from the response with the `200` status - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `f95b50556c93`: 3 breaking, 1 warning, 12 info - added the new path request parameter `tierStructureId` - added the new required request property `name` - added the new required request property `qualification_rules` - removed `#/components/schemas/TierCreateRequest` from the request body `allOf` list - added the new optional request property `downgrade` - added the new optional request property `metadata` - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200` - added the optional property `qualification_rules` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `tier_structure_id` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `9905dfce1d1e`: 9 breaking, 6 warning, 1 info - added `#/components/schemas/TierCreateRequest` to the request body `allOf` list - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `tier_structure_id` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `tierStructureId` - removed the request property `downgrade` - removed the request property `metadata` - removed the request property `name` - removed the request property `qualification_rules` - removed the optional property `qualification_rules` from the response with the `200` status - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `c59a345c733b`: 3 breaking, 1 warning, 12 info - added the new path request parameter `tierStructureId` - added the new required request property `name` - added the new required request property `qualification_rules` - removed `#/components/schemas/TierCreateRequest` from the request body `allOf` list - added the new optional request property `downgrade` - added the new optional request property `metadata` - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200` - added the optional property `qualification_rules` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `tier_structure_id` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `4d4d694f1847`: 9 breaking, 6 warning, 1 info - added `#/components/schemas/TierCreateRequest` to the request body `allOf` list - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `tier_structure_id` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `tierStructureId` - removed the request property `downgrade` - removed the request property `metadata` - removed the request property `name` - removed the request property `qualification_rules` - removed the optional property `qualification_rules` from the response with the `200` status - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `84ad572f8dcb`: 3 breaking, 1 warning, 12 info - added the new path request parameter `tierStructureId` - added the new required request property `name` - added the new required request property `qualification_rules` - removed `#/components/schemas/TierCreateRequest` from the request body `allOf` list - added the new optional request property `downgrade` - added the new optional request property `metadata` - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200` - added the optional property `qualification_rules` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `tier_structure_id` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `58624588b18c`: 9 breaking, 6 warning, 1 info - added `#/components/schemas/TierCreateRequest` to the request body `allOf` list - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `tier_structure_id` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `tierStructureId` - removed the request property `downgrade` - removed the request property `metadata` - removed the request property `name` - removed the request property `qualification_rules` - removed the optional property `qualification_rules` from the response with the `200` status - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200` - **2026-10-13** (v2) `100ea5942966`: 3 breaking, 1 warning, 12 info - added the new path request parameter `tierStructureId` - added the new required request property `name` - added the new required request property `qualification_rules` - removed `#/components/schemas/TierCreateRequest` from the request body `allOf` list - added the new optional request property `downgrade` - added the new optional request property `metadata` - removed `#/components/schemas/Tier` from the response body `allOf` list for the response status `200` - added the optional property `qualification_rules` to the response with the `200` status - added the required property `created_at` to the response with the `200` status - added the required property `downgrade` to the response with the `200` status - added the required property `id` to the response with the `200` status - added the required property `metadata` to the response with the `200` status - added the required property `name` to the response with the `200` status - added the required property `object` to the response with the `200` status - added the required property `tier_structure_id` to the response with the `200` status - added the required property `updated_at` to the response with the `200` status - **2026-10-13** (v2) `ed683aacf90a`: 9 breaking, 6 warning, 1 info - added `#/components/schemas/TierCreateRequest` to the request body `allOf` list - removed the required property `created_at` from the response with the `200` status - removed the required property `downgrade` from the response with the `200` status - removed the required property `id` from the response with the `200` status - removed the required property `metadata` from the response with the `200` status - removed the required property `name` from the response with the `200` status - removed the required property `object` from the response with the `200` status - removed the required property `tier_structure_id` from the response with the `200` status - removed the required property `updated_at` from the response with the `200` status - deleted the `path` request parameter `tierStructureId` - removed the request property `downgrade` - removed the request property `metadata` - removed the request property `name` - removed the request property `qualification_rules` - removed the optional property `qualification_rules` from the response with the `200` status - added `#/components/schemas/Tier` to the response body `allOf` list for the response status `200` - **2026-10-07** (v2) `338a5e34004e`: 2 info - the endpoint scheme security `X-App-Id AND X-App-Token` was added to the API - the endpoint scheme security `bearerAuth` was added to the API - **2026-10-01** (v2) `749b6d105462`: 1 breaking, 1 warning - added the new path request parameter `tierStructureId` - deleted the `path` request parameter `id` - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info - added the optional property `resource_id` to the response with the `400` status - added the optional property `resource_id` to the response with the `404` status - added the optional property `resource_id` to the response with the `409` status - added the optional property `resource_id` to the response with the `500` status - added the optional property `resource_type` to the response with the `400` status - added the optional property `resource_type` to the response with the `404` status - added the optional property `resource_type` to the response with the `409` status - added the optional property `resource_type` to the response with the `500` status - **2026-07-17** (v2) `26ef7b3dd1ef`: 1 breaking, 1 warning - added `subschema #2, subschema #3` to the `qualification_rules/oneOf[#/components/schemas/TierQualificationRulesUpsert]/` request property `allOf` list - removed `subschema #2, subschema #3` from the `qualification_rules/oneOf[#/components/schemas/TierQualificationRulesUpsert]/` request property `allOf` list --- [Operation](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/docs/v2/loyalties/tier-structures/:tierStructureId/tiers/post.md) - [API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [Page](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/tier-structures/:tierStructureId/tiers/post)