---
title: Create organization
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api)

[Organizations](https://developers.cloudflare.com/api/resources/organizations)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Create organization

POST/organizations

Create a new organization for a user. Sub-organization creation availability depends on the organization’s capabilities. The optional `profile` object accepts partial profile details; its individual fields are not required. Organization names are limited to 65 UTF-8 bytes. Each profile field is limited to 1,000 UTF-8 bytes, and a non-empty business email must be valid. At least one of business name, address, phone, or email must be non-empty to persist a profile.

##### Security

<details>

<summary>API Token</summary>



The preferred authorization scheme for interacting with the Cloudflare API. <a href="https://developers.cloudflare.com/fundamentals/api/get-started/create-token/">Create a token</a>.

**Example:**<code>Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY</code>

</details>

<details>

<summary>API Email + API Key</summary>



The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**<code>X-Auth-Email: user@example.com</code>

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**<code>X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194</code>

</details>

##### Accepted Permissions (at least one required)

`User Details Write`

##### Body ParametersJSONExpand Collapse

name: string

The Organization name, limited to 65 UTF-8 bytes.

minLength1

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)

<details>

<summary>

parent: optional object { id }

</summary>

id: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20parent%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20parent%20%3E%20(schema)>)

<details>

<summary>

profile: optional object { business\_address, business\_email, business\_name, 2 more }

Optional profile fields, each limited to 1,000 UTF-8 bytes. An empty profile is ignored.

</summary>

business\_address: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)%20%3E%20(property)%20business_address">Link to this property</a>

business\_email: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)%20%3E%20(property)%20business_email">Link to this property</a>

business\_name: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)%20%3E%20(property)%20business_name">Link to this property</a>

business\_phone: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)%20%3E%20(property)%20business_phone">Link to this property</a>

external\_metadata: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)%20%3E%20(property)%20external_metadata">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20profile%20%3E%20(schema)>)

##### ReturnsExpand Collapse

errors: array of unknown

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

<details>

<summary>

messages: array of <a href="https://developers.cloudflare.com/api/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)">ResponseInfo</a> { code, message, documentation\_url, source }

</summary>

code: number

minimum1000

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20code">Link to this property</a>

message: string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20message">Link to this property</a>

documentation\_url: optional string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20documentation_url">Link to this property</a>

<details>

<summary>

source: optional object { pointer }

</summary>

pointer: optional string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20source%20%3E%20(property)%20pointer">Link to this property</a>

</details>

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20source">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

<details>

<summary>

result: <a href="https://developers.cloudflare.com/api/resources/organizations#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)">Organization</a> { id, create\_time, meta, 3 more }

References an Organization in the Cloudflare data model.

</summary>

id: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

create\_time: string

formatdate-time

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20create_time">Link to this property</a>

<details>

<summary>

meta: object { are\_child\_accounts\_accessible\_by\_org\_members, hierarchy\_tags, managed\_by, 2 more }

</summary>

are\_child\_accounts\_accessible\_by\_org\_members: optional boolean

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20are_child_accounts_accessible_by_org_members">Link to this property</a>

hierarchy\_tags: optional array of string

Ordered chain of organization tags from the root organization down to (and including) this organization itself. Root organizations return a single-element array containing their own tag; sub-organizations return <code>[rootTag, ...intermediateTags, parentTag, selfTag]</code>. Useful for constructing authorization scopes that need to cover every ancestor in the hierarchy.

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20hierarchy_tags">Link to this property</a>

managed\_by: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20managed_by">Link to this property</a>

<details>

<summary>

tenant\_flags: optional object { account\_creation, account\_creation\_applies\_tenant\_defaults, account\_deletion, 5 more }

Enable features for Organizations.

</summary>

account\_creation: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20account_creation">Link to this property</a>

account\_creation\_applies\_tenant\_defaults: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20account_creation_applies_tenant_defaults">Link to this property</a>

account\_deletion: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20account_deletion">Link to this property</a>

account\_migration: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20account_migration">Link to this property</a>

account\_mobility: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20account_mobility">Link to this property</a>

enterprise\_capability: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20enterprise_capability">Link to this property</a>

member\_management: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20member_management">Link to this property</a>

sub\_org\_creation: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags%20%3E%20(property)%20sub_org_creation">Link to this property</a>

</details>

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_flags">Link to this property</a>

tenant\_type: optional string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta%20%3E%20(property)%20tenant_type">Link to this property</a>

</details>

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20meta">Link to this property</a>

name: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

<details>

<summary>

parent: optional object { id, name }

</summary>

id: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20parent%20%3E%20(property)%20id">Link to this property</a>

name: string

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20parent%20%3E%20(property)%20name">Link to this property</a>

</details>

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20parent">Link to this property</a>

<details>

<summary>

profile: optional <a href="https://developers.cloudflare.com/api/resources/accounts#(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)">AccountProfile</a> { business\_address, business\_email, business\_name, 2 more }

</summary>

business\_address: string

<a href="#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile%20%2B%20(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)%20%3E%20(property)%20business_address">Link to this property</a>

business\_email: string

<a href="#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile%20%2B%20(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)%20%3E%20(property)%20business_email">Link to this property</a>

business\_name: string

<a href="#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile%20%2B%20(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)%20%3E%20(property)%20business_name">Link to this property</a>

business\_phone: string

<a href="#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile%20%2B%20(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)%20%3E%20(property)%20business_phone">Link to this property</a>

external\_metadata: string

<a href="#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile%20%2B%20(resource)%20accounts.account_profile%20%3E%20(model)%20account_profile%20%3E%20(schema)%20%3E%20(property)%20external_metadata">Link to this property</a>

</details>

<a href="#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result%20%2B%20(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)%20%3E%20(property)%20profile">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

success: true

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

### Create organization

HTTP

HTTPTypeScriptPythonGoTerraform

```
curl https://api.cloudflare.com/client/v4/organizations \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "name": "x"
        }'
```

200 example

```
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
    "create_time": "2019-12-27T18:11:19.117Z",
    "meta": {
      "are_child_accounts_accessible_by_org_members": true,
      "hierarchy_tags": [
        "string"
      ],
      "managed_by": "managed_by",
      "tenant_flags": {
        "account_creation": "account_creation",
        "account_creation_applies_tenant_defaults": "account_creation_applies_tenant_defaults",
        "account_deletion": "account_deletion",
        "account_migration": "account_migration",
        "account_mobility": "account_mobility",
        "enterprise_capability": "enterprise_capability",
        "member_management": "member_management",
        "sub_org_creation": "sub_org_creation"
      },
      "tenant_type": "tenant_type"
    },
    "name": "name",
    "parent": {
      "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
      "name": "name"
    },
    "profile": {
      "business_address": "business_address",
      "business_email": "business_email",
      "business_name": "business_name",
      "business_phone": "business_phone",
      "external_metadata": "external_metadata"
    }
  },
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
    "create_time": "2019-12-27T18:11:19.117Z",
    "meta": {
      "are_child_accounts_accessible_by_org_members": true,
      "hierarchy_tags": [
        "string"
      ],
      "managed_by": "managed_by",
      "tenant_flags": {
        "account_creation": "account_creation",
        "account_creation_applies_tenant_defaults": "account_creation_applies_tenant_defaults",
        "account_deletion": "account_deletion",
        "account_migration": "account_migration",
        "account_mobility": "account_mobility",
        "enterprise_capability": "enterprise_capability",
        "member_management": "member_management",
        "sub_org_creation": "sub_org_creation"
      },
      "tenant_type": "tenant_type"
    },
    "name": "name",
    "parent": {
      "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
      "name": "name"
    },
    "profile": {
      "business_address": "business_address",
      "business_email": "business_email",
      "business_name": "business_name",
      "business_phone": "business_phone",
      "external_metadata": "external_metadata"
    }
  },
  "success": true
}
```