---
title: "Create a workspace"
method: POST
path: "/api/v1/workspaces"
tags: ["🏢 Workspaces"]
---

# Create a workspace

`POST /api/v1/workspaces`

Creates a new workspace owned by the authenticated user. Subject to the plan's workspace limit.

## Request body

- object
  - `name` string, required
  - `logo` string, url, required
  - `timezone` string, required
  - `super_admin_id` string, nullable — Account owner to create the workspace under. Optional when you are the account owner or are linked to exactly one super admin; required when you manage multiple super admins.
  - `note` string, nullable
  - `instagram_posting_method` 'api' | 'mobile'
  - `first_day` object
    - `day` string
    - `key` integer

## Response `201`

Workspace created successfully

- object
  - `status` boolean
  - `message` string
  - `data` object

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Workspace limit reached or trial expired
- `422` — Validation failed
- `429` — Too Many Requests - Rate limit exceeded

---

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