---
title: "Create a goal"
method: POST
path: "/products/{product_id}/goals"
tags: ["Goals"]
---

# Create a goal

`POST /products/{product_id}/goals`

## Path parameters

- `product_id` string, required

## Request body

- GoalsPostRequest
  - `goal` object
    - `description` string
    - `workflow_status` string

## Response `200`

Successful operation

## Changes

- **2026-08-12** `bfbe6f6d74a1` — 2 breaking, 2 warning
  - the response property `goal/success_metric/workflow_status/workflow_status_category` became nullable for the status `200`
  - the `goal/success_metric/workflow_status/workflow_status_category` response's property type changed from `object` to `null` for status `200`
  - removed the optional property `goal/success_metric/workflow_status/workflow_status_category/id` from the response with the `200` status
  - removed the optional property `goal/success_metric/workflow_status/workflow_status_category/name` from the response with the `200` status
- **2026-07-26** `69bd8c9e8932` — 1 info
  - added the optional property `goal/success_metric/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/goals/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)