---
title: "Create an organization"
method: POST
path: "/api/v1/organizations"
tags: ["Organizations"]
---

# Create an organization

`POST /api/v1/organizations`

Creates a new organization in your environment. Use this endpoint to add a new tenant that can be configured with various settings and metadata

## Request body

- V1organizationsCreateOrganization
  - `display_name` string, required — Name of the organization. Must be between 1 and 200 characters.
  - `external_id` string — Your application's unique identifier for this organization, used to link Scalekit with your system.
  - `logo_url` string, uri — HTTPS URL of the organization's logo image. Maximum 1024 characters. Must use the https scheme.
  - `metadata` object
  - `slug` string — Slug for dynamic redirect URI resolution. A single DNS label (e.g. acme) or hostname (e.g. oauth.pstmn.io). Lowercase alphanumeric, hyphens, and dots. Max 253 chars. Unique per environment.

## Response `201`

Returns the newly created organization with its unique identifier and settings

- OrganizationsCreateOrganizationResponse
  - `organization` OrganizationsOrganization
    - `create_time` string, date-time, required — Timestamp when the organization was created
    - `display_name` string — Name of the organization. Must be between 1 and 200 characters
    - `external_id` string — Your application's unique identifier for this organization, used to link Scalekit with your system.
    - `id` string — Unique scalekit-generated identifier that uniquely references an organization
    - `logo_url` string, uri — HTTPS URL of the organization's logo image. Maximum 1024 characters. Must use the https scheme.
    - `metadata` object — Key value pairs extension attributes.
    - `region_code` 'US' | 'EU'
    - `settings` OrganizationsOrganizationSettings — Configuration options that control organization-level features and capabilities
      - `features` OrganizationsOrganizationSettingsFeature[] — List of feature toggles that control organization capabilities such as SSO authentication and directory synchronization
        - `enabled` boolean, required — Whether the feature is enabled (true) or disabled (false) for this organization
        - `name` string, required — Feature identifier. Supported values include: "sso" (Single Sign-On), "directory_sync" (Directory Synchronization), "domain_verification" (Domain Verification), "session_policy" (Organization-level session policy override)
    - `slug` string — Slug for dynamic redirect URI resolution. A single DNS label (e.g. acme) or hostname (e.g. oauth.pstmn.io). Lowercase alphanumeric, hyphens, and dots. Max 253 chars. Unique per environment.
    - `update_time` string, date-time — Timestamp when the organization was last updated

---

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