Docs API Reference Post Tags/bff/post-tag/create

/bff/post-tag/create

Creates a new tag for posts including route. Tag code is automatically normalized to URL-friendly format. Tag must have a unique code within the organisation.

Post TagspostBffPost-tagCreate

Parameters

JSON body

Request body

application/json

codestringRequired

Unique tag code (URL-friendly, automatically normalized)

Length: 1–100

labelstringRequired

Display name of the tag

Length: 1–200

colorstringOptional

Tag color in #RRGGBB format (optional)

internalbooleanOptional

Mark the tag as internal (private). Internal tags are never returned from public surfaces (post feed, post detail, search). Default: false.

localestringRequired

Locale code for route creation (e.g., cs, en, sk)

Length: 2–2

Response schema

1 status code documented

200Success

idnumberRequired

Internal tag ID.

codestringRequired

Tag code (URL-friendly).

labelstringRequired

Tag display name.

colorstring | nullRequired

One of 2:

Variant 1

string

Tag color in #RRGGBB format.

Variant 2

null

internalbooleanRequired

Whether the tag is internal (private).

Response example

application/json

{
  "id": 0,
  "code": "example_code",
  "label": "example_label",
  "internal": false
}

Request example

POST /bff/post-tag/create

post

curl -X POST "https://api.bizkithub.com/bff/post-tag/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "code": "example_code",
  "label": "example_label",
  "color": "example_color",
  "internal": false,
  "locale": "example_locale"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key