--- title: Create organization --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Organizations](https://developers.cloudflare.com/api/typescript/resources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create organization client.organizations.create(OrganizationCreateParams {name, parent, profile } body, RequestOptionsoptions?): [Organization]() {id, create\_time, meta, 3 more } 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` ##### ParametersExpand Collapse

body: OrganizationCreateParams {name, parent, profile }

name: string Link to this property

parent?: Parent

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

Link to this property

profile?: Profile

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

[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

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: Meta {hierarchy\_tags, managed\_by, tenant\_flags }

hierarchy\_tags?: Array<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?: string Link to this property

tenant\_flags?: TenantFlags {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?: Parent {id, name }

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

Link to this property

profile?: Profile {business\_address, business\_email, business\_name, 2 more }

Link to this property

[Link to this property](<#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)>) ### Create organization TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiEmail: process.env['CLOUDFLARE_EMAIL'], // This is the default and can be omitted apiKey: process.env['CLOUDFLARE_API_KEY'], // This is the default and can be omitted }); const organization = await client.organizations.create({ name: 'name' }); console.log(organization.id); ``` 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 } ```