Skip to contentDevelopersPrezly website
Newsroom categories

Create Newsroom Category

Create a newsroom category with locale-specific names.

Personal token scopes: sites:write. Your account must also have access to the requested data. Authentication

Read the guide

POST
/newsrooms/{newsroom_id}/categories

Personal access tokens: sites:write. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length

Request Body

application/json
  1. body
i18n*

Translations keyed by supported locale code. Omitted locales are preserved on PATCH; null removes a translation.

image?||
is_featured?boolean

Response Body

Created

application/json
  1. response
category*

Categories are used to categorise content in a Newsroom.

Note: Categories are visible publicly on the newsroom website.

Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/categories' \  -H 'Content-Type: application/json' \  -d '{  "i18n": {    "property1": {      "name": "string"    },    "property2": {      "name": "string"    }  }}'
Example Response201
{  "category": {    "id": 0,    "display_name": "string",    "display_description": "string",    "i18n": {      "[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2})?": {        "name": "string",        "description": "string",        "slug": "string",        "locale": {          "code": "en",          "name": "string",          "direction": "ltr",          "language_code": "en",          "native_name": "string"        }      }    },    "stories_number": 0  }}