Skip to main content
POST
/
v1
/
public
/
topic-comments.create
curl --location --request POST 'https://api.userorbit.com/v1/public/topic-comments.create' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123",
  "text": "This would be a great addition!",
  "source": "widget"
}'

{
  "data": {
    "id": "comment-uuid-new",
    "text": "This would be a great addition!",
    "topicId": "topic-uuid-123",
    "creatorId": "sub-uuid-789",
    "parentId": null,
    "source": "widget",
    "createdAt": "2024-01-17T17:30:00Z",
    "subscriber": {
      "id": "sub-uuid-789",
      "name": "John Doe",
      "email": "john@example.com"
    }
  }
}

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

Authorization: Bearer SUBSCRIBER_JWT_TOKEN

​
Request Body

​
id
string
required
Topic ID (UUID) to comment on
​
text
string
required
Comment text content
​
parentId
string
Parent comment ID (UUID) for replies. Omit for top-level comments.
​
source
string
Comment source (e.g., “widget”, “api”, “email”)

​
Response

​
data
object
Created comment object with subscriber info
curl --location --request POST 'https://api.userorbit.com/v1/public/topic-comments.create' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123",
  "text": "This would be a great addition!",
  "source": "widget"
}'

{
  "data": {
    "id": "comment-uuid-new",
    "text": "This would be a great addition!",
    "topicId": "topic-uuid-123",
    "creatorId": "sub-uuid-789",
    "parentId": null,
    "source": "widget",
    "createdAt": "2024-01-17T17:30:00Z",
    "subscriber": {
      "id": "sub-uuid-789",
      "name": "John Doe",
      "email": "john@example.com"
    }
  }
}

​
Behavior

  • Event Trigger: Fires topic-comments.create event for Zapier
  • Team Validation: Subscriber must belong to same team
  • Nested Replies: Supports threaded conversations

​
Webhooks

Triggers Zapier event:
Event: topic-comments.create
{
  "event": "topic-comments.create",
  "commentId": "comment-uuid-new",
  "topicId": "topic-uuid-123",
  "subscriberId": "sub-uuid-789",
  "teamId": "team-uuid"
}

​
Notes

  • Returns full comment with subscriber details
  • Comment immediately visible to all users
  • Supports unlimited nesting via parentId