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

# Create Organization

`POST /api/v0/organizations`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/organizations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/organizations/post.ts> (a function with typed inputs; its response is checked against the schema)

Create an organization with the caller as its admin; 409 for a caller already in one.

It holds no tier, so it opens no capability until staff set one. Its admin can send invitation email under
Outerport's name, so the caller's address must be verified.

## Request body

- CreateOrganizationRequest
  - `name` string, required

## Response `201`

Successful Response

- OrganizationResponse
  - `public_id` string, uuid, required: The public id of the organization.
  - `name` string, required: The name of the organization.
  - `role` string, required: The caller's role in this organization: `admin` or `member`.
  - `created_at` string, date-time, required: When the organization was created.
  - `updated_at` string, date-time, required: When the organization was last updated.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/organizations/post.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)