---
title: "Changes to Add a new goal"
method: POST
path: "/goals"
---

# Changes to Add a new goal

`POST /goals`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 30 revisions.

- **2023-02-03** `6749e4ab1790`: 7 breaking, 1 warning, 2 info
- **2022-10-07** `5f19f075613e`: 3 breaking
- **2022-01-29** `7f35aaa7290d`: 1 info
- **2021-07-29** `0588124176e0`: 1 breaking, 1 info

## Changes

- **2023-02-03** `6749e4ab1790`: 7 breaking, 1 warning, 2 info
  - added the new required request property `assignee`
  - added the new required request property `duration`
  - added the new required request property `expected_outcome`
  - added the new required request property `interval`
  - added the new required request property `type`
  - the request's body type changed from no type to `object`
  - the `data/goal/type/params/pipeline_id` response's property type changed from `string` to `array` for status `200`
  - removed `subschema #1: basicGoalRequest, subschema #2` from the request body `allOf` list
  - added the new optional request property `title`
  - added the optional property `data/goal/type/params/activity_type_id` to the response with the `200` status
- **2022-10-07** `5f19f075613e`: 3 breaking
  - the `data/goal/assignee/id` response's property type changed from `object` to `integer` for status `200`
  - the `data/goal/owner_id` response's property type changed from `string` to `integer` for status `200`
  - the `data/goal/report_ids/items/` response's property type changed from `integer` to `string` for status `200`
- **2022-01-29** `7f35aaa7290d`: 1 info
  - the endpoint scheme security `oauth2` was added to the API
- **2021-07-29** `0588124176e0`: 1 breaking, 1 info
  - removed the media type `application/x-www-form-urlencoded` from the request body
  - added the media type `application/json` to the request body

---

[Operation](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1/docs/goals/post.md) - [API](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1.md) - [Page](https://skmtc.dev/pipedrive/apis/pipedrive-api-v1/changes/goals/post)
