Skip to main content
POST
/
v1
/
public
/
feedback-comments.create
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!"
}'

{
  "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"
  }
}

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.

​
Authentication

Requires subscriber JWT token from login/identify. 
Authorization: Bearer SUBSCRIBER_JWT_TOKEN

​
Request Body

​
feedbackId
string
required
The feedback ID to comment on
​
text
string
required
The comment text content. Minimum 1 character.
​
isPrivate
boolean
default:"false"
Whether this is a private comment (team only). Requires team member authentication.

​
Response

​
data
object
Created comment object
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!"
}'

{
  "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"
  }
}

​
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