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

# Create Organization

`POST /api/organizations`

Creates a new organization under the calling partner account, optionally configuring SSO or OIDC at creation time.

> 🚧 Requires partner key
>
> This endpoint is only accessible using [partner keys](../../guides/obtaining-api-keys#partner-keys).

SSO and OIDC settings supplied at creation time can be updated later via
`PUT /api/organizations/{id}`.

## Headers

- `X-Polytomic-Version` string

## Request body

- CreateOrganizationRequestSchema
  - `client_id` string — OIDC client ID issued by the identity provider.
  - `client_secret` string — OIDC client secret issued by the identity provider. Write-only; never returned in responses.
  - `issuer` string — OIDC issuer URL for organizations using OpenID Connect single sign-on.
  - `name` string, required — Human-readable name of the organization. Must be unique across the partner account.
  - `sso_domain` string — Email domain used to match users to this organization during SSO sign-in.
  - `sso_org_id` string — WorkOS organization identifier linking this organization to its SAML/SSO configuration.

## Response `200`

OK

- OrganizationEnvelope
  - `data` Organization
    - `id` string, uuid — Unique identifier of the organization.
    - `issuer` string — OIDC issuer URL for organizations using OpenID Connect single sign-on.
    - `name` string — Human-readable name of the organization.
    - `sso_domain` string — Email domain used to match users to this organization during SSO sign-in.
    - `sso_org_id` string — WorkOS organization identifier linking this organization to its SAML/SSO configuration.

## Other responses

- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)