---
title: "Create a guide. Always lands as a draft. Admin only."
method: POST
path: "/api/v1/marketing/admin/guides"
tags: ["Marketing"]
---

# Create a guide. Always lands as a draft. Admin only.

`POST /api/v1/marketing/admin/guides`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/marketing/admin/guides`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

## Request body

- GuideUpsertRequest
  - `author` string
  - `body_markdown` string, required
  - `canonical_to` string, nullable
  - `description` string, required
  - `faqs` GuideFaq[], required
    - `a` string, required
    - `q` string, required
  - `featured` boolean
  - `headline` string, required
  - `hero_alt` string, required
  - `hero_image` string, required
  - `noindex` boolean
  - `og_image` string, required
  - `pillar` string
  - `popular_rank` integer, nullable
  - `publish_date` string, date, required
  - `quotable_answer` string, required
  - `related` string[]
  - `section` string
  - `slug` string, required
  - `stat` string, required
  - `title` string, required
  - `updated_date` string, date, nullable

## Response `201`

Created

- GuideResponse: Admin-facing row view (snake_case, includes status).
  - `author` string, required
  - `body_markdown` string, required
  - `canonical_to` string, nullable
  - `description` string, required
  - `faqs` GuideFaq[], required
    - `a` string, required
    - `q` string, required
  - `featured` boolean, required
  - `headline` string, required
  - `hero_alt` string, required
  - `hero_image` string, required
  - `id` integer, required
  - `noindex` boolean, required
  - `og_image` string, required
  - `pillar` string, required
  - `popular_rank` integer, nullable
  - `preview_token` string, nullable
  - `publish_date` string, date, required
  - `quotable_answer` string, required
  - `related` string[], required
  - `section` string, required
  - `slug` string, required
  - `stat` string, required
  - `status` string, required
  - `title` string, required
  - `updated_date` string, date, required

## Other responses

- `409`: Conflict
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)