---
title: "Create an idea"
method: POST
path: "/products/{product_id}/ideas"
tags: ["Ideas"]
---

# Create an idea

`POST /products/{product_id}/ideas`

Creates a new idea with basic details including initial vote count

## Path parameters

- `product_id` string, required

## Request body

- IdeasPostRequest
  - `promotable_type` string
  - `release_id` integer

## Response `200`

Successful operation

## Changes

- **2026-08-12** `bfbe6f6d74a1` — 2 breaking, 2 warning
  - the response property `idea/workflow_status/workflow_status_category` became nullable for the status `200`
  - the `idea/workflow_status/workflow_status_category` response's property type/format changed from `object`/`` to `null`/`` for status `200`
  - removed the optional property `idea/workflow_status/workflow_status_category/id` from the response with the `200` status
  - removed the optional property `idea/workflow_status/workflow_status_category/name` from the response with the `200` status
- **2026-07-26** `69bd8c9e8932` — 1 info
  - added the optional property `idea/workflow_status/workflow_status_category` to the response with the `200` status

[Change history](https://skmtc.dev/aha/apis/aha-api/changes/products/:product_id/ideas/post.md)

---

[API](https://skmtc.dev/aha/apis/aha-api.md) · [All operations](https://skmtc.dev/aha/apis/aha-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aha/aha-api/revisions/f2725b45bcf3/schema)