--- 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. (Currently in Public Beta - see https://developers.cloudflare.com/fundamentals/organizations/) ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `User Details Write` ##### Body ParametersJSONExpand Collapse name: string [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)>)

parent: optional object {id, name }

id: string Link to this property name: string Link to this property

[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)>)

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

business\_address: string Link to this property business\_email: string Link to this property business\_name: string Link to this property business\_phone: string Link to this property external\_metadata: string Link to this property

[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>)

messages: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

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

result: Organization { id, create\_time, meta, 3 more } References an Organization in the Cloudflare data model.

id: string Link to this property create\_time: string formatdate-time Link to this property

meta: object {hierarchy\_tags, managed\_by, tenant\_flags }

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 [rootTag, ...intermediateTags, parentTag, selfTag]. Useful for constructing authorization scopes that need to cover every ancestor in the hierarchy. Link to this property managed\_by: optional string Link to this property

tenant\_flags: optional object {account\_creation, account\_creation\_applies\_tenant\_defaults, account\_deletion, 5 more } Enable features for Organizations.

account\_creation: string Link to this property account\_creation\_applies\_tenant\_defaults: string Link to this property account\_deletion: string Link to this property account\_migration: string Link to this property account\_mobility: string Link to this property enterprise\_capability: string Link to this property member\_management: string Link to this property sub\_org\_creation: string Link to this property

Link to this property

Link to this property name: string Link to this property

parent: optional object {id, name }

id: string Link to this property name: string Link to this property

Link to this property

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

Link to this property

[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 "X-Auth-Email: $CLOUDFLARE_EMAIL" \ -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \ -d '{ "name": "name" }' ``` 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": { "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" } }, "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": { "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" } }, "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 } ```