Skip to main content
POST
/
api
/
v1
/
orgs
/
{org}
/
orgs
Create an organization
curl --request POST \
  --url https://auth.cognite.com/api/v1/orgs/{org}/orgs \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": "my-org",
      "idp": {
        "idpVendor": "AZURE_AD",
        "issuer": "https://login.microsoftonline.com/some-tenant-id/v2.0"
      },
      "migrationStatus": "EXCLUSIVE_LOGIN",
      "adminGroupId": "my-external-group",
      "adminsCanCreateOrgsInSubtree": false,
      "adminsCanCreateProjectsInSubtree": false,
      "allowedClusters": [
        "westeurope-1",
        "asia-northeast1-1"
      ]
    }
  ]
}
'
{
  "items": [
    {
      "id": "my-org",
      "parentId": "my-org",
      "idp": {
        "idpVendor": "AZURE_AD",
        "issuer": "https://login.microsoftonline.com/some-tenant-id/v2.0"
      },
      "adminsCanCreateOrgsInSubtree": false,
      "adminsCanCreateProjectsInSubtree": false,
      "allowedClusters": [
        "westeurope-1",
        "asia-northeast1-1"
      ],
      "migrationStatus": "EXCLUSIVE_LOGIN",
      "adminGroupId": "my-external-group",
      "isDeleted": false,
      "profilesEnabled": true
    }
  ]
}

Path Parameters

org
string
required

ID of an organization The ID of an organization

Required string length: 3 - 64
Pattern: ^([a-z][a-z0-9-]{1,62}[a-z0-9])$
Example:

"my-org"

Body

application/json

A request to create an organization.

items
object[]
required
Required array length: 1 element

Response

A successfully created organization

items
object[]
required
Required array length: 1 element
Last modified on April 23, 2026