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

# POST /comments

`POST /comments`

Creates a new comment

## Query parameters

- `user_id` string, required

## Request body

- CreateCommentRequestBody
  - `entityType` 'Track' | 'FanClub' | 'Event', required — Type of entity that can be commented on
  - `entityId` integer, required — ID of the entity being commented on
  - `body` string, required — Comment text
  - `commentId` integer — Optional ID for the comment (will be generated if not provided)
  - `parentId` integer — Parent comment ID if this is a reply
  - `trackTimestampS` integer — Timestamp in the track where the comment was made (in seconds)
  - `mentions` integer[] — Array of user IDs mentioned in the comment (max 10)
  - `videoUrl` string, nullable — Optional URL for a video attachment (stored on the comment record)

## Response `201`

Comment created successfully

- CreateCommentResponse
  - `transaction_hash` string — The blockchain transaction hash
  - `block_hash` string — The blockchain block hash
  - `block_number` integer — The blockchain block number/height
  - `comment_id` string — The ID of the created comment

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error

---

[API](https://skmtc.dev/audius/apis/audius-api.md) · [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/audius/audius-api/revisions/940230b2ed3d/schema)