---
title: "Create article in a knowledge base in default locale"
method: POST
path: "/knowledge_bases/{knowledge_base_id}/articles"
tags: ["Knowledge Bases"]
---

# Create article in a knowledge base in default locale

`POST /knowledge_bases/{knowledge_base_id}/articles`

Creates an article in a knowledge base in the default locale.

Required scope: `knowledge_bases:write`

## Path parameters

- `knowledge_base_id` string, required

## Request body

- KnowledgeBaseArticleCreate
  - `category_id` string — ID of the category this article belongs to
  - `author_id` string — Teammate ID of the article author
  - `subject` string — Subject of the article
  - `content` string — HTML content of the article
  - `status` 'draft' | 'published' — Article status

## Response `201`

A knowledge base article with content

- KnowledgeBaseArticleResponse
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `knowledge_base` string — Link to the article's knowledge base
      - `category` string — Link to the article's category
      - `last_editor` string — Link to the article's last editor
  - `id` string, required — Unique identifier of the knowledge base article
  - `slug` string, required — URL slug of the article. Construct the full URL using the template of protocol/knowledge base domain/locale/slug, such as https://yourDomain.com/en/articles/5
  - `name` string, required — Name of the article
  - `status` string, required — Status of the article
  - `keywords` string[], required — Article keywords
  - `content` string, required — Article HTML content
  - `locale` string, required — Locale of the article
  - `attachments` Attachment[], required — List of files attached to the article
    - `id` string, required — The unique identifier of the attachment.
    - `filename` string, required — Name of the attached file
    - `url` string, required — URL to download the attached file
    - `content_type` string, required — Content type of the attached file in [MIME format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). Note that some attachments types may not be supported.
    - `size` integer, required — Size (in byte) of the attached file
    - `metadata` object, required — Attachment metadata
      - `is_inline` boolean — Whether or not the attachment is part of the message body
      - `cid` string — Unique identifier used to link an attachment to where it is used in the message body
  - `last_edited_at` number — Timestamp when the article was last edited
  - `created_at` number — Timestamp when the article was created
  - `updated_at` number — Timestamp when the article was updated

---

[API](https://skmtc.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)