--- title: Create organization --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Organizations](https://developers.cloudflare.com/api/go/resources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create organization client.Organizations.New(ctx, body) (\*[Organization](), error) 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 OrganizationNewParams Organization param.Field\[Organization] References an Organization in the Cloudflare data model. Link to this property
[Link to this property](<#(resource)%20organizations%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Organization struct{…} References an Organization in the Cloudflare data model. ID string Link to this property CreateTime Time formatdate-time Link to this property
Meta OrganizationMeta HierarchyTags \[]stringOptional 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 ManagedBy stringOptional Link to this property
TenantFlags OrganizationMetaTenantFlagsOptional Enable features for Organizations. AccountCreation string Link to this property AccountCreationAppliesTenantDefaults string Link to this property AccountDeletion string Link to this property AccountMigration string Link to this property AccountMobility string Link to this property EnterpriseCapability string Link to this property MemberManagement string Link to this property SubOrgCreation string Link to this property
Link to this property
Link to this property Name string Link to this property
Parent OrganizationParentOptional ID string Link to this property Name string Link to this property
Link to this property
Profile AccountProfileOptional BusinessAddress string Link to this property BusinessEmail string Link to this property BusinessName string Link to this property BusinessPhone string Link to this property ExternalMetadata string Link to this property
Link to this property
[Link to this property](<#(resource)%20organizations%20%3E%20(model)%20organization%20%3E%20(schema)>) ### Create organization Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/organizations" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) organization, err := client.Organizations.New(context.TODO(), organizations.OrganizationNewParams{ Organization: organizations.OrganizationParam{ Name: cloudflare.F("name"), }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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 } ```