Goals API

Create a goal

POST /api/v1/products/:product_id/goals

product_id *

Numeric ID or key of the product

project_id *

Numeric ID or key of the project the goals should be created in

name *

Name of the goal


Description of the goal — may include HTML formatting.


Value between 1 and 100 describing the goal's position on the effort axis in the goal chart


Value between 1 and 100 describing the goal's position on the value axis in the goal chart


ID of a goal to roll up to in the parent line, Roll up a goal to a parent line goal by 1) creating a goal for the parent line 2) choosing that goal in this control. You can then visualize how releases relate to your strategic goals throughout Aha!

success_metric_name *

Name of the Metric that will be used to measure this goal's success

success_metric_description *

Description of the success metric

success_metric_status *

Status of the success metric for the goal


Name or ID of time frame for this goal


Source for calculating progress on the goal. Options are: progress_manual, progress_from_features, progress_from_releases, progress_from_initiatives, progress_from_descendants, progress_from_features_completed, progress_from_epics, progress_from_key_results.


Progress completed on the goal. May only be set when the progress_source is manual.

Example request

POST /api/v1/products/PRJ1/goals

Example CURL command

curl "https://company.aha.io/api/v1/products/PRJ1/goals" -d '{"goal":{"name":"Goal 3","success_metric":{"name":"FooBar","description":"Foo Bar","workflow_status":"Not Started"},"time_frame":{"name":"2015"},"description":"Our first big goal","effort":15,"value":5}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"


authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
contentType: application/json
accept: application/json

Request body


Status: 200 OK
contentType: application/json; charset=utf-8

Response body