v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Goals

Create Key Results

Creates one or more key results for a specific goal. <br> Each key result will be created with the specified title, measureBy properties, and automatically associated with the given goal.<br><br> Limitations:<br> - You can create up to 25 key results per request.<br> - If the request includes more than 25 items, it will return a 400 error.<br><br> The response includes an array of the created key result IDs. <br> If any key result fails to be created, a structured error response will be returned with details for each failed item. <br><br> Testing notes: <br> - Use the testing widget's Try It! option to test this endpoint.<br> - Use the Examples > Request Example option to see how to initiate body parameters.<br>

post/goals/goals/{goalId}/key-results

Path parameters

goalIdinteger required

The unique identifier of the goal to create key results for

Request body

Example request

{
  "items": [
    {
      "fields": {
        "currency": {
          "value": "USD"
        },
        "currencySymbol": {
          "value": "$"
        }
      }
    }
  ]
}

Response

Key results created successfully

keyResultIdsinteger[]

Array of created key result IDs