---
title: "Changes to Create a simulation"
method: POST
path: "/simulations"
---

# Changes to Create a simulation

`POST /simulations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 19 revisions.

- **2026-10-26** (v1) `bbc0c72039c8`: 2 info
- **2026-02-02** (v1) `9ba8be0f2006`: 10 breaking, 1 warning, 5 info
- **2025-05-27** (v1) `e57c515077cc`: 5 warning, 7 info
- **2025-05-07** (v1) `aeb882657253`: 1 breaking, 3 warning, 4 info
- **2025-03-07** (v1) `a3359d7731fd`: 3 info
- **2024-12-06** (v1) `274e5b2be190`: 1 info

## Changes

- **2026-10-26** (v1) `bbc0c72039c8`: 2 info
  - the request required property `oneOf[subschema #1: Single event]/notification_setting_id` became not read-only
  - the request required property `oneOf[subschema #2: Scenario]/notification_setting_id` became not read-only
- **2026-02-02** (v1) `9ba8be0f2006`: 10 breaking, 1 warning, 5 info
  - request body became required
  - removed `#/components/schemas/simulation-standard-events-create, #/components/schemas/simulation-scenario-events-create` from the request body `oneOf` list
  - the request's body type changed from `object` to no type
  - added `#/components/schemas/SimulationStandardEventsModel, #/components/schemas/SimulationScenarioEventsModel` to the `data` response property `oneOf` list for the response status `201`
  - the `data` response's property type changed from `object` to no type for status `201`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `error/code` from the response with the `default` status
  - removed the required property `error/detail` from the response with the `default` status
  - removed the required property `error/documentation_url` from the response with the `default` status
  - removed the required property `error/type` from the response with the `default` status
  - removed the optional property `error/errors` from the response with the `default` status
  - added `#/components/schemas/SimulationStandardEventsCreate, #/components/schemas/SimulationScenarioEventsCreate` to the request body `oneOf` list
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - the response property `error` became required for the status `default`
  - the response property `meta` became required for the status `default`
  - removed `#/components/schemas/simulation-standard-events, #/components/schemas/simulation-scenario-events` from the `data` response property `oneOf` list for the response status `201`
- **2025-05-27** (v1) `e57c515077cc`: 5 warning, 7 info
  - added the new `api_key.created` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `api_key.expired` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `api_key.expiring` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `api_key.revoked` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `api_key.updated` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - the `discount_simulated_as` request property default value changed from `none` to `not_provided`
  - added the new `api_key.created` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `api_key.expired` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `api_key.expiring` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `api_key.revoked` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `api_key.updated` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - the `discount_simulated_as` response's property default value changed from `none` to `not_provided` for the status `201`
- **2025-05-07** (v1) `aeb882657253`: 1 breaking, 3 warning, 4 info
  - the request property `oneOf[subschema #2: Scenario]/config/oneOf[subschema #2: Subscription creation config]/subscription_creation/entities/anyOf[subschema #1: Subscription creation config without prices]/discount_id` became not nullable
  - added the new `payment_method.deleted` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `payment_method.saved` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `transaction.revised` enum value to the `data/oneOf[subschema #1: Single event]/type` response property for the response status `201`
  - added the new `payment_method.deleted` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `payment_method.saved` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added the new `transaction.revised` enum value to the request property `oneOf[subschema #1: Single event]/type`
  - added `#/components/schemas/discount_id, subschema #2` to the `oneOf[subschema #2: Scenario]/config/oneOf[subschema #2: Subscription creation config]/subscription_creation/entities/anyOf[subschema #1: Subscription creation config without prices]/discount_id` request property `oneOf` list
- **2025-03-07** (v1) `a3359d7731fd`: 3 info
  - added the new optional request property `oneOf[subschema #2: Scenario]/config`
  - added the optional property `data/oneOf[subschema #1: Single event]/config` to the response with the `201` status
  - added the optional property `data/oneOf[subschema #2: Scenario]/config` to the response with the `201` status
- **2024-12-06** (v1) `274e5b2be190`: 1 info
  - endpoint added

---

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