Attachments1

Authorization2

Comments10

Custom Fields6

Custom Task Types1

Folders7

Goals8

Guests10

Lists11

Members2

Roles1

Shared Hierarchy1

Spaces5

Tags6

Task Checklists6

Task Relationships4

Tasks10

Templates3

Time Tracking13

Time Tracking (Legacy)4

User Groups4

Users4

Webhooks4

Workspaces3

Goals

Create Goal

Changed on Nov 3, 2026

Add a new Goal to a Workspace.

post/v2/team/{team_id}/goal

Request

Base URL
https://api.clickup.com/api
URL
https://api.clickup.com/api/v2/team/{team_id}/goal
Auth
API key in header Authorization

Path parameters

team_idnumber required

Example:123

Workspace ID

Request body

namestring required

due_dateinteger required

descriptionstring required

multiple_ownersboolean required

ownersinteger[] required

Array of user IDs.

colorstring required

Example request

{
  "name": "Goal Name",
  "due_date": 1568036964079,
  "description": "Goal Description",
  "multiple_owners": true,
  "owners": [
    183
  ],
  "color": "#32a852"
}

Response

goalGoal required(unresolved $ref)

Example response

{
  "goal": {
    "id": "e53a033c-900e-462d-a849-4a216b06d930",
    "name": "Goal Name",
    "team_id": "512",
    "date_created": "1568044355026",
    "start_date": null,
    "due_date": "1568036964079",
    "description": "Goal Description",
    "private": false,
    "archived": false,
    "creator": 183,
    "color": "#32a852",
    "pretty_id": "6",
    "multiple_owners": true,
    "folder_id": null,
    "members": [],
    "owners": [
      {
        "id": 183,
        "username": "John Doe",
        "initials": "JD",
        "email": "johndoe@gmail.com",
        "color": "#827718",
        "profilePicture": "https://attachments-public.clickup.com/profilePictures/183_abc.jpg"
      }
    ],
    "key_results": [],
    "percent_completed": 0,
    "history": [],
    "pretty_url": "https://app.clickup.com/512/goals/6"
  }
}

Changes

Nov 3, 2026a0a72ec97ddb Revision changes
- breaking
  the response's property type changed from no type to object for status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history