---
title: "Create a space"
method: POST
path: "/spaces"
---

# Create a space

`POST /spaces`

Creates a new Ghost space. Requires user authentication (JWT).
API keys cannot be used to create spaces.
When no name is provided, the space is named after its owner
(e.g. "Jane Doe's space").

## Request body

- CreateSpaceRequest
  - `name` string — Name for the new space. When omitted, the space is named after its owner (e.g. "Jane Doe's space").

## Response `201`

Space created

- Space — A Ghost space.
  - `id` string, required — Space ID.
  - `name` string, required — Space name.

## Other responses

- `default` — Error response

## Changes

- **2026-06-12** `3df7d8e78add` — 1 info
  - the request property `name` became optional
- **2026-04-17** `a7becb6668ec` — 1 breaking, 2 warning
  - the request property `name` became required
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `role` from the response with the `201` status

[Change history](https://skmtc.dev/timescale/apis/ghost-api/changes/spaces/post.md)

---

[API](https://skmtc.dev/timescale/apis/ghost-api.md) · [All operations](https://skmtc.dev/timescale/apis/ghost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/timescale/ghost-api/revisions/3df7d8e78add/schema)