> ## Documentation Index
> Fetch the complete documentation index at: https://developer.surefeedback.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create comment

> Create a new comment on a page.

Creates a new comment associated with a page on a site. Typically used by the widget, but can also be called from server-side integrations.

<Note>
  Requires authentication. The user must have access to the site.
</Note>

## Request body

<ParamField body="user" type="object" required>
  Information about the user creating the comment.
</ParamField>

<ParamField body="user.org_id" type="string" required>
  UUID of the organisation the comment belongs to.
</ParamField>

<ParamField body="user.name" type="string">
  Display name for the user creating the comment.
</ParamField>

<ParamField body="user.role" type="string">
  User role, for example `admin`, `member`, or `guest`.
</ParamField>

<ParamField body="site" type="object" required>
  Information about the site the comment belongs to.
</ParamField>

<ParamField body="site.site_id" type="string" required>
  UUID of the site.
</ParamField>

<ParamField body="site.domain" type="string" required>
  Site domain, for example `example.com`.
</ParamField>

<ParamField body="comment" type="object" required>
  Comment payload.
</ParamField>

<ParamField body="comment.content" type="string" required>
  Comment text content.
</ParamField>

<ParamField body="comment.priority" type="string">
  Priority level: `LOW`, `MEDIUM`, or `HIGH`. Default: `MEDIUM`.
</ParamField>

<ParamField body="context" type="object" required>
  Page context for the comment.
</ParamField>

<ParamField body="context.page_url" type="string" required>
  Full URL of the page the comment is on.
</ParamField>

<ParamField body="context.timestamp" type="string" required>
  ISO 8601 timestamp in UTC, for example `2026-03-25T11:36:24.000Z`.
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "message": "Comment created successfully",
    "data": {
      "comment": {
        "id": "990e8400-e29b-41d4-a716-446655440004",
        "content": "The header looks misaligned on mobile.",
        "status": "OPEN",
        "priority": "HIGH",
        "page_url": "https://example.com/home",
        "created_at": "2026-03-02T12:00:00Z"
      }
    }
  }
  ```
</ResponseExample>