Create a post

Create a new feedback post. Supports JSON or multipart/form-data (for file attachments).

The description field accepts markdown or plain text, which is automatically converted to rich text for storage.

Authorization

bearerAuth

AuthorizationBearer <token>

API key with sk_live_ or sk_test_ prefix. Create keys in your workspace settings.

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Post title

Length1 <= length

description?string

Post description (markdown or plain text)

postTypeId*string

Post type ID (get available types from /post-types)

statusId?string

Initial status ID (get available statuses from /statuses)

tagIds?array<string>

Tag IDs to associate (get available tags from /tags)

author?

Attribute the post to a specific user. If the email matches an existing user, that user is used. Otherwise, a new user is created and added to the workspace as a Member. If omitted, the post is attributed to the API key owner.

Response Body

`application/json`

curl -X POST "https://app.fdback.io/api/v1/posts" \  -H "Content-Type: application/json" \  -d '{    "title": "string",    "postTypeId": "string"  }'

{
  "data": {
    "id": "string",
    "title": "string",
    "description": {},
    "descriptionHtml": "string",
    "postTypeId": "string",
    "statusId": "string",
    "votesCount": 0,
    "commentsCount": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "test": true
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Missing required field: title",
    "status": 400
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key.",
    "status": 401
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please try again later.",
    "status": 429
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`