---
title: "Create Organizations"
description: "This documentation outlines the process and rules for creating organizations within the walt.id Enterprise API."
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/administration/organizations/create
generated: 2026-07-08
---
# Create Organizations

This documentation outlines the process and rules for creating organizations within the walt.id Enterprise API.

## Creation Permissions

### Default Behavior
- By default, only super-admin users are allowed to create an organization via the `/v1/admin/organizations` endpoint. 

### Allow Anyone To Create An Organization
- When the `create-organization` feature is enabled via the Feature Manager:
  - **Every Account (without any permissions)** is permitted to create new organizations

## Automatic Role Assignment

### Admin Role Creation
- When a new organization is created, the system automatically generates an admin role
- The admin role follows the naming convention: `{organizationID}.admin`

### Creator Role Assignment
- The user who creates the organization is automatically assigned the automatically created admin role (`{organizationID}.admin`)

## Create a new Organization (As Super Admin)

**Option: CURL**

**Endpoint:** `/v1/admin/organizations` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Administration%20(Global)%20%2F%20Organizations/post_v1_admin_organizations)

**Example Request**

```bash
curl -X 'POST' \
  'https://enterprise.sandbox.walt.id/v1/admin/organizations' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "_id": "test",
  "profile": {
    "name": "Test GmbH"
  },
  "billing": {
    "billingCountry": "AT",
    "billingAddress": "test 111/115, 1090 Vienna",
    "vatNr": "test"
  }
}'
```

**Body**

```json
{
  "_id": "string",
  "profile": {
    "name": "string"
  },
  "billing": {
    "billingCountry": "",
    "billingAddress": "",
    "vatNr": "",
    "iban": "",
    "swift": ""
  }
}
```

**Body Parameters**

- `_id`
  - `type`: _String_ - Unique identifier for the organization, e.g. `waltid`

- `profile`
  - `name`: _String_ - Human readable name for the organization.

- `billing`: Billing information

---

**Response Codes**

- `201` - Organization created successfully.

## Create a new Organization (As Regular User)

**Note:**

Please note, this requires the optional feature`create-organization` to be enabled via the Feature Manager.

<br/>

**Option: CURL**

**Endpoint:** `/v1/admin/organizations`

**Example Request**

```bash
curl -X 'POST' \
  'https://enterprise.sandbox.walt.id/v1/admin/organizations' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "_id": "test",
  "profile": {
    "name": "Test GmbH"
  },
  "billing": {
    "billingCountry": "AT",
    "billingAddress": "test 111/115, 1090 Vienna",
    "vatNr": "test"
  }
}'
```

**Body**

```json
{
  "_id": "string",
  "profile": {
    "name": "string"
  },
  "billing": {
    "billingCountry": "",
    "billingAddress": "",
    "vatNr": "",
    "iban": "",
    "swift": ""
  }
}
```

**Body Parameters**

- `_id`
  - `type`: _String_ - Unique identifier for the organization, e.g. `waltid`

- `profile`
  - `name`: _String_ - Human readable name for the organization.

- `billing`: Billing information

---

**Response Codes**

- `201` - Organization created successfully.