Sign in

v4

latestOpenAPI 3.1.1Apache 2.02026-07-31107278570.4 KB
Organizations

Create an organization

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

post/api/v1/organizations

Request body

display_namestring required

Name of the organization. Must be between 1 and 200 characters.

external_idstring

Your application's unique identifier for this organization, used to link Scalekit with your system.

logo_urlstring uri

HTTPS URL of the organization's logo image. Maximum 1024 characters. Must use the https scheme.

metadataobject
slugstring

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.

Example request

{
  "display_name": "Megasoft Inc",
  "external_id": "my_unique_id",
  "logo_url": "https://cdn.example.com/acme-logo.png",
  "slug": "acme"
}

Response

Returns the newly created organization with its unique identifier and settings

Example response

{
  "organization": {
    "create_time": "2025-02-15T06:23:44.560000Z",
    "display_name": "Megasoft",
    "external_id": "my_unique_id",
    "id": "org_59615193906282635",
    "logo_url": "https://cdn.example.com/acme-logo.png",
    "settings": {
      "features": [
        {
          "enabled": true,
          "name": "sso"
        },
        {
          "enabled": false,
          "name": "directory_sync"
        }
      ]
    },
    "slug": "acme",
    "update_time": "2025-02-15T06:23:44.560000Z"
  }
}