# Create organization

Create an organization that represents your business customer or partner. This should be called from the backend, using an admin access token (generated by a management app). Required permissions: organizations:create, orgs:create.

Endpoint: POST /v1/organizations
Security: AdminAccessToken

## Request fields (application/json):

  - `name` (string, required)
    Name of the organization

  - `domains` (array, required)
    Domains of the organization

  - `app_ids` (array, required)
    A list of applications the organization can access

  - `enabled` (boolean)
    Indicates if the organization is currently enabled

  - `alias_name` (string)
    Alias name of the organization

  - `domain` (string, required)
    Domain of the organization

## Response 201 fields (application/json):

  - `result` (object, required)

  - `result.organization_id` (string, required)
    ID of the organization

  - `result.app_ids` (array, required)
    A list of applications the organization can access

  - `result.name` (string, required)
    Name of the organization

  - `result.domains` (array)
    Domains of the organization

  - `result.created_at` (number)
    Date the organization was created in the tenant

  - `result.updated_at` (number)
    Date the organization was last updated

  - `result.enabled` (boolean, required)
    Indicates if the organization is currently enabled

  - `result.managed_organizations_by_app` (object)
    Mapping of app IDs to managed organization IDs assigned to this app

  - `result.managing_organization_id` (string)
    ID of the managing organization

  - `result.logo_url` (string)
    The URL of the organization's logo

  - `result.alias_name` (string)
    Alias name of the organization

  - `result.domain` (string, required)
    Domain of the organization

## Response 400 fields (application/json):

  - `message` (array, required)
    Example: "Bad request"

  - `error_code` (number, required)
    Example: 400

## Response 409 fields (application/json):

  - `message` (string, required)

  - `error_code` (number, required)

  - `ts_error_code` (string, required)