---
search:
  tags:
    - Article Endpoints
    - POST
seo:
  description: >-
    Step 1 of 5 — Create an empty draft and get an article_id. Reference for the
    POST /x/articles/draft endpoint in the TwexAPI REST API API.
sidebar:
  badge: POST
  label: '[Step 1/5] Create a new article draft'
title: '[Step 1/5] Create a new article draft'
type: openapi-operation
---
**Step 1 of 5** — Create an empty draft and get an `article_id`.

The `article_id` returned here is required by all subsequent steps.

**Full flow:**
1. ➡️ `POST /x/articles/draft` — get `article_id`
2. `PUT  /x/articles/{article_id}/cover` — *(optional)* set cover image
3. `PUT  /x/articles/{article_id}/title` — set title
4. `PUT  /x/articles/{article_id}/content` — set body (Markdown)
5. `POST /x/articles/{article_id}/publish` — publish and get `tweet_id`

> 💡 **Tip:** For full control (e.g. preview before publish, retry individual steps), use the step-by-step flow above. Use `POST /x/articles/publish` only for quick one-shot publishing.

<Operation source="api-reference" id="article-create-draft-x-articles-draft-post" />