---
title: "Create article"
method: POST
path: "/knowledge-base/1/articles"
tags: ["customer-engagement", "knowledge-base", "knowledge-base-articles"]
---

# Create article

`POST /knowledge-base/1/articles`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/knowledge-base/1/articles`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Creates a new knowledge base article with the provided content, tags, and category assignment.

## Request body

- 09ef6171198229ad9a73a413d2271afa3ba31b9abbd6cd8a0cc9563fd721f1edCreateUpdateArticleRequest
  - `name` string, required: Name of the article.
  - `content` string, required: Content of the article in HTML format.
  - `status` 'PUBLISHED' | 'DRAFT', required: Workflow status of the article.
  - `tags` string[], required: List of tag names to assign to the article.
  - `links` string[], required: List of attachment identifiers to link to the article.
  - `categoryId` string, uuid, required: Category identifier to assign the article to.
  - `folderId` string, uuid: Folder identifier within the category.

## Response `201`

Article created successfully

- 09ef6171198229ad9a73a413d2271afa3ba31b9abbd6cd8a0cc9563fd721f1edArticleRefResponse
  - `id` string, uuid, required: Unique identifier of the article.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)