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

# Create Feedback Comment

> Add a comment to a feedback item. Requires subscriber authentication.

## Authentication

Requires subscriber JWT token from login/identify.

```bash theme={null}
Authorization: Bearer SUBSCRIBER_JWT_TOKEN
```

## Request Body

<ParamField body="feedbackId" type="string" required>
  The feedback ID to comment on
</ParamField>

<ParamField body="text" type="string" required>
  The comment text content. Minimum 1 character.
</ParamField>

<ParamField body="isPrivate" type="boolean" default="false">
  Whether this is a private comment (team only). Requires team member authentication.
</ParamField>

## Response

<ResponseField name="data" type="object">
  Created comment object

  <Expandable title="Comment Properties">
    <ResponseField name="id" type="string">
      Comment ID (UUID)
    </ResponseField>

    <ResponseField name="text" type="string">
      Comment content
    </ResponseField>

    <ResponseField name="feedbackId" type="string">
      Feedback this comment belongs to
    </ResponseField>

    <ResponseField name="subscriberId" type="string">
      ID of subscriber who created the comment
    </ResponseField>

    <ResponseField name="subscriber" type="object">
      Subscriber details
    </ResponseField>

    <ResponseField name="isPrivate" type="boolean">
      Whether comment is private
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://api.userorbit.com/v1/public/feedback-comments.create' \
  --header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "feedbackId": "feedback-uuid",
    "text": "This would be really useful for our team!"
  }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.userorbit.com/v1/public/feedback-comments.create', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      feedbackId: 'feedback-uuid',
      text: 'This would be really useful for our team!'
    })
  });

  const { data: comment } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.userorbit.com/v1/public/feedback-comments.create',
      headers={
          'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
          'Content-Type': 'application/json'
      },
      json={
          'feedbackId': 'feedback-uuid',
          'text': 'This would be really useful for our team!'
      }
  )

  comment = response.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "id": "comment-uuid",
      "text": "This would be really useful for our team!",
      "feedbackId": "feedback-uuid",
      "subscriberId": "subscriber-uuid",
      "subscriber": {
        "id": "subscriber-uuid",
        "name": "John Doe",
        "email": "john@example.com",
        "avatarUrl": "https://example.com/avatar.jpg"
      },
      "isPrivate": false,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  }
  ```
</ResponseExample>

## Behavior

* **Auto-Subscribe**: Creator automatically subscribed to feedback notifications
* **Moderation**: May require approval if team has moderation enabled
* **Notifications**: Triggers notifications to feedback creator and other subscribers
* **Private Comments**: Only team members can create private comments

## Use Cases

* **User Engagement**: Allow users to discuss feedback
* **Team Responses**: Team members can respond to feedback
* **Internal Notes**: Team members can add private notes

## Notes

* Requires valid subscriber JWT token
* Empty text will fail validation
* Private comments only visible to team members
* Comment count incremented automatically
* Triggers webhook events if configured