---
title: "Create News"
method: POST
path: "/v1/news"
tags: ["News"]
---

# Create News

`POST /v1/news`

Creates a new news post.

## Request body

- NewsCreate
  - `date` string, date — The date of the news
  - `image_url` union — The URL of the image for the news
    - string, uri
    - ''
  - `tags` string, required — The tags of the news, separated by commas
  - `order_id` integer — The order ID of the news
  - `category` 'bugfix' | 'company_news' | 'event' | 'maintenance' | 'update', required
  - `published_at` integer — The published date of the news
  - `datetime` integer, required — The date of the news
  - `render_options` NewsRenderOptions
    - `is_promo_store` boolean
  - `video_url` string, uri — The URL of the video for the news
  - `is_featured` boolean — Determines the visibility of the news in the Carousel news block
  - `collection_id` string — The collection ID this news belongs to
  - `requirements_expression` ExpressionSchemaInput — Pydantic v2 mirror of `campaign_user.expr.Expression` for the v2 News API.
    - `tokens` TokenSchema[]
      - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
      - `value` unknown
    - `variables` MathExpressionSchemaInput[]
      - `tokens` TokenSchema[]
        - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
        - `value` unknown
      - `name` string, required
  - `slug` string, required — The slug of the news
  - `title` string, required — The title of the news
  - `description` string, required — The description of the news
  - `text` string, required — The text of the news
  - `html` string — The html content of the news

## Response `201`

Successful Response

- NewsRead
  - `date` string, date — The date of the news
  - `image_url` union — The URL of the image for the news
    - string, uri
    - ''
  - `tags` string, required — The tags of the news, separated by commas
  - `order_id` integer — The order ID of the news
  - `category` 'bugfix' | 'company_news' | 'event' | 'maintenance' | 'update', required
  - `published_at` integer — The published date of the news
  - `datetime` integer, required — The date of the news
  - `render_options` NewsRenderOptions
    - `is_promo_store` boolean
  - `video_url` string, uri — The URL of the video for the news
  - `is_featured` boolean — Determines the visibility of the news in the Carousel news block
  - `collection_id` string — The collection ID this news belongs to
  - `requirements_expression` ExpressionSchemaOutput — Pydantic v2 mirror of `campaign_user.expr.Expression` for the v2 News API.
    - `tokens` TokenSchema[]
      - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
      - `value` unknown
    - `variables` MathExpressionSchemaOutput[]
      - `tokens` TokenSchema[]
        - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
        - `value` unknown
      - `name` string, required
  - `id` string, required — The unique identifier of the news
  - `slug` string, required — The slug of the news
  - `title` string, required — The title of the news
  - `description` string — The description of the news
  - `text` string, required — The text of the news
  - `html` string — The html content of the news

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/0c1b4ac1865b/schema)