ZITADEL Docs
APIsCore ResourcesV2Organization

AddOrganization

Add Organization

Create a new organization with an administrative user. If no specific roles are sent for the users, they will be granted the role ORG_OWNER.

Required permission:

  • org.create
POST
/v2/organizations

Request Body

application/json

name*string

Name is the unique name of the organization to be created. This must be unique across the instance.

admins?

Specify users to be assigned as organization admins. If no users are specified here, the organization will be created without any admin users. The organization can still be managed by any instance administrator. If no roles are specified for a user, they will be assigned the role ORG_OWNER.

organizationId?string

OrganizationID is the unique identifier of the organization. This field is optional. If omitted, the system will generate one, which is the recommended way. The generated ID will be returned in the response.

orgId?stringDeprecated

Optionally, set a unique id for the organization. If omitted, the system will generate one, which is the recommended way. The generated ID will be returned in the response.

Deprecated: use 'organization_id' field instead. If both org_id and organization_id are set, organization_id will take precedence.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/v2/organizations" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{
  "details": {
    "sequence": 0,
    "changeDate": "1s",
    "resourceOwner": "string",
    "creationDate": "1s"
  },
  "organizationId": "string",
  "createdAdmins": [
    {
      "userId": "string",
      "emailCode": "string",
      "phoneCode": "string"
    }
  ]
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?