---
title: "Create Question"
method: POST
path: "/api/frameworks/questions"
tags: ["frameworks"]
---

# Create Question

`POST /api/frameworks/questions`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/frameworks/questions`
- Auth: HTTP bearer

Create a new custom question for the organization.

## Request body

- QuestionCreate
  - `question_text` string, required
  - `category` string, nullable
  - `career_phase` string, nullable
  - `probing_questions` string[], nullable
  - `what_to_listen_for` string[], nullable
  - `framework_code` string, required
  - `competency_id` string, nullable

## Response `201`

Successful Response

- QuestionResponse
  - `question_text` string, required
  - `category` string, nullable
  - `career_phase` string, nullable
  - `probing_questions` string[], nullable
  - `what_to_listen_for` string[], nullable
  - `id` string, required
  - `framework_code` string, required
  - `competency_id` string, nullable
  - `competency_name` string, nullable
  - `organization_id` string, nullable
  - `is_system_default` boolean, required
  - `source` string, required
  - `is_active` boolean, required
  - `usage_count` integer, required
  - `created_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)