Skip to main content
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"
}'

{
  "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": []
  }
}

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

This endpoint requires subscriber authentication. Use the JWT token from subscriber.identify in the Authorization header or publicAccessToken cookie. 
Authorization: Bearer SUBSCRIBER_JWT_TOKEN

​
Request Body

​
title
string
required
Feedback title. Brief summary of the feedback.
​
text
string
Detailed description of the feedback. Supports plain text.
​
type
string
Custom feedback type. Can be used for categorization.
​
boardId
string
UUID of the feedback board to post to. If not provided, feedback won’t be assigned to a specific board.
​
meta
object
Custom metadata object. Can store any additional information.

​
Response

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

{
  "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 publicBoardModeration enabled, feedback starts unpublished and requires approval
  • Default Status: New feedback defaults to in_review status
  • Default Priority: New feedback defaults to medium priority
  • Auto-subscribe: Creator is automatically subscribed to notifications
  • Webhooks: Triggers feedbacks.create event 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)