---
title: "Create the active blog for the authenticated website."
method: POST
path: "/api/v1/blog"
tags: ["Blog"]
---

# Create the active blog for the authenticated website.

`POST /api/v1/blog`

## Request

- Base URL: `https://api.unicornplatform.com`
- URL: `https://api.unicornplatform.com/api/v1/blog`
- Auth: HTTP bearer

A website can have only one active blog. Returns 409 when an active blog already exists.

## Request body

- BlogInput
  - `postsDirectory` string: Blog root directory. Defaults to /blog when omitted.
  - `metaTitle` string
  - `metaDescription` string

## Response `201`

Blog was created.

- Blog
  - `id` string, required
  - `postsDirectory` string, required
  - `metaTitle` string, required
  - `metaDescription` string, required
  - `canonicalOrigin` string, required
  - `hosts` string[], required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid blog payload.
- `401`: Missing or invalid bearer token.
- `409`: The authenticated website already has an active blog.

---

[API](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api.md) - [All operations](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unicornplatform/apis/unicorn-platform-partner-api/revisions/809eeac0c51c?raw)