---
title: "Create Organization Endpoint"
method: POST
path: "/api/me/organizations"
tags: ["me"]
---

# Create Organization Endpoint

`POST /api/me/organizations`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/me/organizations`
- Auth: none declared

Create an organization. The caller becomes its owner.

No approval queue: an organization with no members is inert, so the cost of
a spurious one is a row. Creating the tenant is the whole act - migration
1066's trigger provisions the identity and the Mind in the same transaction.

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- CreateOrganizationIn
  - `display_name` string, required
  - `mindset_id` string, uuid, nullable
  - `reply_workflow` 'manual' | 'send', nullable
  - `confirm_reply_workflow` boolean

## Response `201`

Successful Response

- OrganizationDetailOut: Everything the organization page renders (TOS-4113).
  - `tenant_id` string, uuid, required
  - `display_name` string, required
  - `slug` string, required
  - `logo_url` string, nullable, required
  - `my_role` string, required
  - `can_manage` boolean, required
  - `can_manage_owners` boolean, required
  - `discoverable` boolean, required
  - `members` OrganizationSeatOut[], required
    - `identity_id` string, uuid, required
    - `display_name` string, required
    - `email` string, nullable, required
    - `role` string, required
    - `source` string, required
    - `granted_by` string, uuid, nullable, required
    - `is_agent` boolean, required
  - `join_rules` OrganizationJoinRuleOut[], required
    - `id` string, uuid, required
    - `kind` string, required
    - `value` string, required
    - `default_role` string, required
  - `pending_join_requests` OrganizationJoinRequestOut[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `identity_id` string, uuid, required
    - `display_name` string, required
    - `email` string, nullable, required
    - `status` string, required
    - `message` string, nullable, required
    - `created_at` string, date-time, required
    - `decided_at` string, date-time, nullable, required
  - `conversation_status` OrganizationConversationStatusOut, required
    - `state` 'ready' | 'mindset_required' | 'confirmation_required' | 'funding_required', required
    - `blocking_reasons` string[], required
    - `can_configure` boolean, required

## Other responses

- `422`: Validation Error

---

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