---
title: "Create comment"
method: POST
path: "/comments"
tags: ["Comments"]
---

# Create comment

`POST /comments`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/comments`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Same as `POST /notes/{note_id}/comments`, with the note given as `note_id` in the body. Users named in `notify_user_ids` are added to the note's notification recipients.

## Request body

- object
  - `comment` object, required
    - `user_id` integer: The owner of the comment
    - `comment` string: The content of the comment
    - `edited_by_person_id` integer: The user id of the last person to edit the note; must be manually set when updating a comment.
    - `note_id` integer, required: The note the comment belongs to
    - `notify_user_ids` integer[]: Users to add to the note's notification recipients. Ignored on update.

## Response `200`

Successful Response

- CommentAll
  - `id` integer: Unique identifier
  - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
  - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
  - `user` object: A convenience object to get the full name of the comment owner
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `avatar_thumb_url` string, nullable
  - `user_id` integer: The owner of the comment
  - `comment` string: The content of the comment
  - `edited_by_person_id` integer: The user id of the last person to edit the note; must be manually set when updating a comment.

## Other responses

- `404`: No record with that id is visible to this user. Records owned by other users that you cannot see also answer 404.
- `422`: The request was understood but a value is missing, invalid or too long.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)