#Create Organizations

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

#Creation Permissions

#Default Behavior

• By default, any user can create an organization without requiring specific permissions.

#Restricted Creation

• When the create-organization feature is disabled via the Feature Manager:
  • Only super-admins are 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

curl -X 'POST' \
  'https://enterprise-sandbox.waltid.dev/v1/organization/create' \
  -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"
  }
}'

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