curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.create' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard. This would reduce eye strain during late-night work sessions.",
"boardId": "33333333-1234-1234-1234-123456789012"
}'
const response = await fetch('https://api.userorbit.com/v1/public/feedbacks.create', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Add dark mode support',
text: 'It would be great to have a dark mode option for the dashboard.',
boardId: '33333333-1234-1234-1234-123456789012'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.create',
headers={
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
json={
'title': 'Add dark mode support',
'text': 'It would be great to have a dark mode option for the dashboard.',
'boardId': '33333333-1234-1234-1234-123456789012'
}
)
data = response.json()
{
"data": {
"id": "22222222-1234-1234-1234-123456789012",
"urlId": "abc123def456",
"url": "/add-dark-mode-support-abc123def456",
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard.",
"status": "in_review",
"priority": "medium",
"boardId": "33333333-1234-1234-1234-123456789012",
"creatorId": "87654321-1234-1234-1234-123456789012",
"teamId": "11111111-1234-1234-1234-123456789012",
"feedbackVotesCount": 0,
"feedbackCommentsCount": 0,
"publishedAt": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"archivedAt": null,
"lastModifiedById": null,
"meta": {},
"subscriber": {
"id": "87654321-1234-1234-1234-123456789012",
"name": "John Doe",
"email": "john@example.com",
"source": "widget",
"meta": {},
"avatarUrl": null,
"createdAt": "2024-01-10T08:00:00Z",
"lastUpdated": "2024-01-15T10:30:00Z"
},
"lastModifiedBy": null,
"tags": []
}
}
Management
Create Feedback (Public)
Create new feedback from public widget. Requires authenticated subscriber via JWT token.
POST
/
v1
/
public
/
feedbacks.create
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.create' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard. This would reduce eye strain during late-night work sessions.",
"boardId": "33333333-1234-1234-1234-123456789012"
}'
const response = await fetch('https://api.userorbit.com/v1/public/feedbacks.create', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Add dark mode support',
text: 'It would be great to have a dark mode option for the dashboard.',
boardId: '33333333-1234-1234-1234-123456789012'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.create',
headers={
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
json={
'title': 'Add dark mode support',
'text': 'It would be great to have a dark mode option for the dashboard.',
'boardId': '33333333-1234-1234-1234-123456789012'
}
)
data = response.json()
{
"data": {
"id": "22222222-1234-1234-1234-123456789012",
"urlId": "abc123def456",
"url": "/add-dark-mode-support-abc123def456",
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard.",
"status": "in_review",
"priority": "medium",
"boardId": "33333333-1234-1234-1234-123456789012",
"creatorId": "87654321-1234-1234-1234-123456789012",
"teamId": "11111111-1234-1234-1234-123456789012",
"feedbackVotesCount": 0,
"feedbackCommentsCount": 0,
"publishedAt": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"archivedAt": null,
"lastModifiedById": null,
"meta": {},
"subscriber": {
"id": "87654321-1234-1234-1234-123456789012",
"name": "John Doe",
"email": "john@example.com",
"source": "widget",
"meta": {},
"avatarUrl": null,
"createdAt": "2024-01-10T08:00:00Z",
"lastUpdated": "2024-01-15T10:30:00Z"
},
"lastModifiedBy": null,
"tags": []
}
}
Authentication
This endpoint requires subscriber authentication. Use the JWT token fromsubscriber.identify in the Authorization header or publicAccessToken cookie.
Authorization: Bearer SUBSCRIBER_JWT_TOKEN
Request Body
string
required
Feedback title. Brief summary of the feedback.
string
Detailed description of the feedback. Supports plain text.
string
Custom feedback type. Can be used for categorization.
string
UUID of the feedback board to post to. If not provided, feedback won’t be assigned to a specific board.
object
Custom metadata object. Can store any additional information.
Response
object
Created feedback object
Show Feedback Object
Show Feedback Object
string
Feedback ID (UUID)
string
Short URL identifier
string
URL path (/title-urlId)
string
Feedback title
string
Feedback description
string
Status: in_review, in_progress, planned, completed, closed
string
Priority: low, medium, high, urgent
string
Board ID (if assigned)
string
Subscriber ID who created it
string
Team ID
number
Number of votes
number
Number of comments
string
Publication timestamp (ISO 8601)
string
Creation timestamp
string
Last update timestamp
object
Creator subscriber object
array
Array of tag objects
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.create' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard. This would reduce eye strain during late-night work sessions.",
"boardId": "33333333-1234-1234-1234-123456789012"
}'
const response = await fetch('https://api.userorbit.com/v1/public/feedbacks.create', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Add dark mode support',
text: 'It would be great to have a dark mode option for the dashboard.',
boardId: '33333333-1234-1234-1234-123456789012'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.create',
headers={
'Authorization': 'Bearer SUBSCRIBER_JWT_TOKEN',
'Content-Type': 'application/json'
},
json={
'title': 'Add dark mode support',
'text': 'It would be great to have a dark mode option for the dashboard.',
'boardId': '33333333-1234-1234-1234-123456789012'
}
)
data = response.json()
{
"data": {
"id": "22222222-1234-1234-1234-123456789012",
"urlId": "abc123def456",
"url": "/add-dark-mode-support-abc123def456",
"title": "Add dark mode support",
"text": "It would be great to have a dark mode option for the dashboard.",
"status": "in_review",
"priority": "medium",
"boardId": "33333333-1234-1234-1234-123456789012",
"creatorId": "87654321-1234-1234-1234-123456789012",
"teamId": "11111111-1234-1234-1234-123456789012",
"feedbackVotesCount": 0,
"feedbackCommentsCount": 0,
"publishedAt": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z",
"archivedAt": null,
"lastModifiedById": null,
"meta": {},
"subscriber": {
"id": "87654321-1234-1234-1234-123456789012",
"name": "John Doe",
"email": "john@example.com",
"source": "widget",
"meta": {},
"avatarUrl": null,
"createdAt": "2024-01-10T08:00:00Z",
"lastUpdated": "2024-01-15T10:30:00Z"
},
"lastModifiedBy": null,
"tags": []
}
}
Behavior
- Moderation: If team has
publicBoardModerationenabled, feedback starts unpublished and requires approval - Default Status: New feedback defaults to
in_reviewstatus - Default Priority: New feedback defaults to
mediumpriority - Auto-subscribe: Creator is automatically subscribed to notifications
- Webhooks: Triggers
feedbacks.createevent for Zapier integrations
Use Cases
- Feature Requests: Users suggest new features
- Bug Reports: Users report issues
- General Feedback: Users provide product feedback
- Ideas: Users share product ideas
Notes
- Subscriber must belong to the same team as the board
- Board must exist and belong to the team
- Empty title will fail validation
- URL is auto-generated from title and urlId
- Feedback is immediately visible to team (unless moderation is enabled)
Was this page helpful?

