Comment on a deal

​

Posts a comment on one deal, attributed to whoever the token belongs to. body is the only field, and unsafe HTML is stripped before it is stored. A deal you cannot see returns 404.

Posting a comment notifies nobody — deal comments do not send notifications today. Who gets notified is decided entirely by the deal, never by what the comment says.

@-mentions do not work here. Writing @Alex in body stores those characters and nothing more: it does not link to Alex, does not notify Alex, and there is no parameter that would. If you need to reach a specific person, this is not the endpoint for it.

Attachments are not supported either.

Path Parameters
  • deal_id
    Type: string
    required

    The deal to comment on — the deal's numeric id.

Body
required
application/json

The comment, wrapped in a comment key.

  • comment
    Type: object
    required
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/public-api/v1/deals/{deal_id}/comments
curl 'https://app.hellobonsai.com/public-api/v1/deals/{deal_id}/comments' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "comment": {
    "body": "Looks good to me!"
  }
}'

{
  "data": {
    "id": 5821,
    "kind": "user_created",
    "commentable_type": "Task",
    "created_at": "2026-04-14T09:12:04.000Z",
    "body_plain_text": "Looks good to me!",
    "commentable_id": "ad3fdad8-5072-46df-8800-bb57299179df",
    "author_member_id": 314
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

The comment was posted.