---
title: "Create a team organization."
method: POST
path: "/organizations"
tags: ["organizations"]
---

# Create a team organization.

`POST /organizations`

## Request

- Base URL: `https://api.shorebird.dev/api/v1`
- URL: `https://api.shorebird.dev/api/v1/organizations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Creates a team organization owned by the signed-in user. A user's
first owned organization is free; any further one requires a plan
with the collaboration feature (`shorebird_plan_insufficient_tier`
otherwise). Service accounts cannot create organizations.

## Request body

- CreateOrganizationRequest: The request body for POST /organizations.
  - `name` string, required: The name of the organization. Must not be blank.

## Response `201`

The newly-created organization.

- Organization: An organization groups users and apps together.
  - `id` integer, required: The unique identifier for the organization.
  - `name` string, required: The name of the organization.
  - `organization_type` 'personal' | 'team', required: Every organization is `team`. `personal` was a single-user organization created with each account; none are created any more and existing ones are being converted, so the value is kept only so older clients can still parse responses.
  - `created_at` string, date-time, required: When this organization was created.
  - `updated_at` string, date-time, required: When this organization was last updated.

## Other responses

- `400`: The body could not be parsed (`organizations_create_error`), or the name is blank (`organization_name_blank`).
- `403`: The caller is a service account (`service_account_forbidden`), or the caller already owns an organization and their plan does not include collaboration (`shorebird_plan_insufficient_tier`).
- `424`: Creating the organization failed (`organizations_create_error`).
- `default`: Standard error response. Emitted for any non-2xx status where a body can be decoded into an [ErrorResponse].

## Changes

- **2026-11-05** `941da8871d10`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/shorebird/apis/shorebird-codepush-api.md) - [All operations](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/revisions/941da8871d10?raw)