# POST `/api/public/articles`

> Part of the `Buuk Public API` API reference.

**Create an article**

Requires a write token. Optional markdown is converted to editor JSON.

Base URL: `https://app.getbuuk.com`

## Authentication

Authentication:
  - `bearerAuth` — HTTP BEARER

## Request body

Content type: `application/json`

Request body (required):

- `title` — string — required, example: "Getting started"
- `sectionTitle` — string — example: "Getting started"
- `contentMarkdown` — string

## Responses

### 201 — Article created as a draft unless published later

### 403 — Read-only token

---

View in browser: /help/demo/reference/ba7bd285-7bbd-482d-a97c-73c96995cd3b
Generated from the `Buuk Public API` reference for `demo`.