---
title: "Create a child organization"
method: POST
path: "/api/v1/org"
tags: ["Organizations"]
---

# Create a child organization

`POST /api/v1/org`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v1/org`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a child organization.

This endpoint requires the
[multi-organization account](https://docs.datadoghq.com/account_management/multi_organization/)
feature and must be enabled by
[contacting support](https://docs.datadoghq.com/help/).

Once a new child organization is created, you can interact with it
by using the `org.public_id`, `api_key.key`, and
`application_key.hash` provided in the response.

## Request body

- OrganizationCreateBody: Object describing an organization to create.
  - `billing` OrganizationBilling: A JSON array of billing type.
    - `type` string: The type of billing. Only `parent_billing` is supported.
  - `name` string, required: The name of the new child-organization, limited to 32 characters.
  - `subscription` OrganizationSubscription: Subscription definition.
    - `type` string: The subscription type. Types available are `trial`, `free`, and `pro`.

## Response `200`

OK

- OrganizationCreateResponse: Response object for an organization creation.
  - `api_key` ApiKey: Datadog API key.
    - `created` string: Date of creation of the API key.
    - `created_by` string: Datadog user handle that created the API key.
    - `key` string: API key.
    - `name` string: Name of your API key.
  - `application_key` ApplicationKey: An application key with its associated metadata.
    - `hash` string: Hash of an application key.
    - `name` string: Name of an application key.
    - `owner` string: Owner of an application key.
  - `org` Organization: Create, edit, and manage organizations.
    - `billing` OrganizationBilling: A JSON array of billing type.
      - `type` string: The type of billing. Only `parent_billing` is supported.
    - `created` string: Date of the organization creation.
    - `description` string: Description of the organization.
    - `name` string: The name of the child organization, limited to 32 characters.
    - `public_id` string: The `public_id` of the organization you are operating within.
    - `settings` OrganizationSettings: A JSON array of settings.
      - `private_widget_share` boolean: Whether or not the organization users can share widgets outside of Datadog.
      - `saml` OrganizationSettingsSaml: Set the boolean property enabled to enable or disable single sign on with SAML. See the SAML documentation for more information about all SAML settings.
        - `enabled` boolean: Whether or not SAML is enabled for this organization.
      - `saml_autocreate_access_role` 'st' | 'adm' | 'ro' | 'ERROR', nullable: The access role of the user. Options are **st** (standard user), **adm** (admin user), or **ro** (read-only user).
      - `saml_autocreate_users_domains` OrganizationSettingsSamlAutocreateUsersDomains: Has two properties, `enabled` (boolean) and `domains`, which is a list of domains without the @ symbol.
        - `domains` string[]: List of domains where the SAML automated user creation is enabled.
        - `enabled` boolean: Whether or not the automated user creation based on SAML domain is enabled.
      - `saml_can_be_enabled` boolean: Whether or not SAML can be enabled for this organization.
      - `saml_idp_endpoint` string: Identity provider endpoint for SAML authentication.
      - `saml_idp_initiated_login` OrganizationSettingsSamlIdpInitiatedLogin: Has one property enabled (boolean).
        - `enabled` boolean: Whether SAML IdP initiated login is enabled, learn more in the [SAML documentation](https://docs.datadoghq.com/account_management/saml/#idp-initiated-login).
      - `saml_idp_metadata_uploaded` boolean: Whether or not a SAML identity provider metadata file was provided to the Datadog organization.
      - `saml_login_url` string: URL for SAML logging.
      - `saml_strict_mode` OrganizationSettingsSamlStrictMode: Has one property enabled (boolean).
        - `enabled` boolean: Whether or not the SAML strict mode is enabled. If true, all users must log in with SAML. Learn more on the [SAML Strict documentation](https://docs.datadoghq.com/account_management/saml/#saml-strict).
    - `subscription` OrganizationSubscription: Subscription definition.
      - `type` string: The subscription type. Types available are `trial`, `free`, and `pro`.
    - `trial` boolean: Only available for MSP customers. Allows child organizations to be created on a trial plan.
  - `user` User: Create, edit, and disable users.
    - `access_role` 'st' | 'adm' | 'ro' | 'ERROR', nullable: The access role of the user. Options are **st** (standard user), **adm** (admin user), or **ro** (read-only user).
    - `disabled` boolean: The new disabled status of the user.
    - `email` string: The new email of the user.
    - `handle` string: The user handle, must be a valid email.
    - `icon` string: Gravatar icon associated to the user.
    - `name` string: The name of the user.
    - `verified` boolean: Whether or not the user logged in Datadog at least once.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v1-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/revisions/ca5871004d26?raw)