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

# Create a child organization

`POST /api/v1/org`

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.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)