---
title: "Create a HelpCenter article"
method: POST
path: "/v1/helpcenter/articles"
tags: ["HelpCenter"]
---

# Create a HelpCenter article

`POST /v1/helpcenter/articles`

Creates a HelpCenter article in draft status

## Request body

- ExternalArticleCreateSchema — Payload for creating a Help Center article via the external API. Articles are always created as drafts. Content is expected as HTML and is converted to the internal Slate format before storage.
  - `title` string, required
  - `categoryId` string, uuid, required
  - `content` string, required
  - `description` string, nullable
  - `tags` string, nullable
  - `slug` string, nullable

## Response `201`

Successful Response

- ExternalArticleResponseSchema
  - `id` string, uuid, nullable
  - `categoryId` string, uuid, required
  - `companyId` string, uuid, required
  - `slug` string, required
  - `order` number, required
  - `lastPublishedAt` string, date-time, nullable
  - `title` string, required
  - `description` string, nullable
  - `content` string, nullable
  - `tags` string, nullable
  - `upVotes` integer
  - `downVotes` integer
  - `mentions` integer
  - `pageTitle` string, nullable
  - `canonicalUrl` string, nullable
  - `segments` string[], nullable
  - `locale` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/atlas/apis/atlas-api.md) · [All operations](https://skmtc.net/atlas/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlas/atlas-api/revisions/2590aa53fcf2/schema)