---
search:
  tags:
    - Comments
    - POST
seo:
  description: >-
    Add a comment to a post. Supports @mentions using the format @[Display…
    Reference for the POST /posts/{postId}/comments endpoint in the Ordinal API.
sidebar:
  label: Create a comment on a post
  badge: POST
title: Create a comment on a post
type: openapi-operation
---
Add a comment to a post. Supports @mentions using the format `@[Display Name](userId)`. Tagged users must be workspace members. The commenter and any tagged users are automatically subscribed to the post.

`POST /posts/{postId}/comments`
