---
title: "Create Scenario"
method: POST
path: "/scenarios"
tags: ["scenarios"]
---

# Create Scenario

`POST /scenarios`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/scenarios`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

Create a new scenario.

## Request body

- ScenarioCreate: Input schema for creating a new scenario.
  - `name` string, required: Unique scenario identifier
  - `display_name` string, required: Human-readable name
  - `description` string, required: Detailed description of the scenario
  - `action_cards_prompt_id` string, uuid, required: ID of the action cards prompt
  - `suggested_responses_prompt_id` string, uuid, nullable: ID of the suggested responses prompt
  - `coaching_prompt_id` string, uuid, nullable: ID of the coaching prompt
  - `summary_prompt_id` string, uuid, nullable: ID of the call summary prompt
  - `tagging_prompt_id` string, uuid, nullable: ID of the call tagging prompt
  - `tool_names` string[]: Associated tool names
  - `scenario_metadata` object: Additional metadata
  - `is_active` boolean: Whether scenario is active
  - `mode` string, nullable: Scenario mode: 'training' or 'production'
  - `customer_simulation_prompt` string, nullable: Customer simulation prompt for training mode
  - `scorecard_template_key` string, nullable: QA scorecard template key for this scenario. Validated against the in-process template registry. Falls back to QA_SCORECARD_DEFAULT_TEMPLATE.

## Response `201`

Successful Response

- ScenarioResponse: Response data for a scenario.
  - `id` string, uuid, required
  - `name` string, required
  - `display_name` string, required
  - `description` string, required
  - `action_cards_prompt_id` string, uuid, nullable
  - `suggested_responses_prompt_id` string, uuid, nullable
  - `coaching_prompt_id` string, uuid, nullable
  - `summary_prompt_id` string, uuid, nullable
  - `tagging_prompt_id` string, uuid, nullable
  - `tool_names` string[], required
  - `scenario_metadata` object, required
  - `is_active` boolean, required
  - `is_default` boolean, required
  - `mode` string, required
  - `scorecard_template_key` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/whispa/apis/whispa-api.md) - [All operations](https://skmtc.dev/whispa/apis/whispa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whispa/apis/whispa-api/revisions/12c2e4aca43c?raw)