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"
}'
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": "I completely agree!",
"parentId": "comment-uuid-parent",
"source": "widget"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topic-comments.create', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
id: topicId,
text: 'Great idea!',
source: 'widget'
})
});
const { data: comment } = await response.json();
{
"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"
}
}
}
Comments
Create Topic Comment
Add a comment or reply to a topic. Requires subscriber authentication.
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"
}'
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": "I completely agree!",
"parentId": "comment-uuid-parent",
"source": "widget"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topic-comments.create', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
id: topicId,
text: 'Great idea!',
source: 'widget'
})
});
const { data: comment } = await response.json();
{
"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"
}
}
}
Authentication
Authorization: Bearer SUBSCRIBER_JWT_TOKEN
Request Body
string
required
Topic ID (UUID) to comment on
string
required
Comment text content
string
Parent comment ID (UUID) for replies. Omit for top-level comments.
string
Comment source (e.g., “widget”, “api”, “email”)
Response
object
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"
}'
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": "I completely agree!",
"parentId": "comment-uuid-parent",
"source": "widget"
}'
const response = await fetch('https://api.userorbit.com/v1/public/topic-comments.create', {
method: 'POST',
headers: {
'Authorization': `Bearer ${subscriberToken}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
id: topicId,
text: 'Great idea!',
source: 'widget'
})
});
const { data: comment } = await response.json();
{
"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.createevent 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
Was this page helpful?

