# POST /simulations/{simulation_id}/runs

**Create a run for a simulation**

Creates a new simulation run for a simulation.

If successful, your response includes a copy of the new simulation run entity.

**Required permissions:** `notification_simulation.write`

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `simulation_id` | string | required | Paddle ID of the simulation entity to work with. |

## Response (201)

- `data` (required) — Represents a simulation run entity.
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": {
    "id": "ntfsimrun_01j82h13n87yq2sfv187hm2r0p",
    "status": "pending",
    "type": "subscription_creation",
    "created_at": "2024-09-18T12:17:04.168467Z",
    "updated_at": "2024-09-18T12:17:04.168467Z"
  },
  "meta": {
    "request_id": "2201997e-d23b-4a49-acdb-8a9f8cc72ff6"
  }
}
```