---
title: "Create Goal Comment"
method: POST
path: "/api/v1/performance/employees/{employeeId}/goals/{goalId}/comments"
tags: ["Goals", "Public API"]
---

# Create Goal Comment

`POST /api/v1/performance/employees/{employeeId}/goals/{goalId}/comments`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/performance/employees/{employeeId}/goals/{goalId}/comments`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `goal.write`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/performance/employees/:employeeId/goals/:goalId/comments/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new comment on a goal. The goal must belong to the specified employee. Returns the newly created comment object including its assigned ID.

OAuth Scopes: goal.write

## Path parameters

- `employeeId` string, required
- `goalId` string, required

## Request body

- object
  - `text` string, required: The text content of the comment.

## Response `201`

A goal comment object with the new goal comment ID.

- object
  - `id` string: The comment ID.
  - `authorUserId` integer: The user ID of the comment author.
  - `createdAt` string: ISO 8601 UTC timestamp when the comment was created.
  - `text` string: The text content of the comment.
  - `canEdit` boolean: Whether the authenticated caller can edit this comment.
  - `canDelete` boolean: Whether the authenticated caller can delete this comment.

## Other responses

- `400`: The goal does not belong to the specified employee, or the comment text is blank.
- `403`: If the authenticated caller does not have permission to add a comment to the specified goal.
- `404`: The specified goalId was not found.

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)