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

# Create Comment

`POST /comments`

Create a new comment

## Request body

- HandlerParamsCommentCreate
  - `content` string, required — The comment content
  - `email` string, required — The comment email
  - `link` string — The comment link
  - `name` string, required — The comment name
  - `page_key` string, required — The comment page_key
  - `page_title` string — The comment page_title
  - `rid` integer — The comment rid
  - `site_name` string, required — The site name of your content scope
  - `ua` string — The comment ua

## Response `200`

OK

- HandlerResponseCommentCreate
  - `badge_color` string, required
  - `badge_name` string, required
  - `content` string, required
  - `content_marked` string, required
  - `date` string, required
  - `email_encrypted` string, required
  - `id` integer, required
  - `ip_region` string
  - `is_allow_reply` boolean, required
  - `is_collapsed` boolean, required
  - `is_pending` boolean, required
  - `is_pinned` boolean, required
  - `is_verified` boolean, required
  - `link` string, required
  - `nick` string, required
  - `page_key` string, required
  - `page_url` string, required
  - `rid` integer, required
  - `site_name` string, required
  - `ua` string, required
  - `user_id` integer, required
  - `visible` boolean, required
  - `vote_down` integer, required
  - `vote_up` integer, required

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

- **2024-01-24** `83bbd341664a` — 1 info
  - endpoint added
- **2023-01-28** `6a7a8a92e7c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/artalkjs/apis/artalk-api/changes/comments/post.md)

---

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