--- title: Create an Account --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Accounts](https://developers.cloudflare.com/api/python/resources/accounts) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create an Account accounts.create(AccountCreateParams\*\*kwargs) -> [Account]() POST/accounts Create an Account. To create the Account within an Organization, provide `unit.id` and omit `standalone`. To create a standalone Free Account, provide `standalone: true` and omit `unit`. Providing both fields is invalid. If you omit both fields, Cloudflare can determine the destination only when the User is an administrator of exactly one Organization. Cloudflare creates the Account in that Organization; otherwise, the request returns an error. ##### 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` ##### ParametersExpand Collapse name: str Account name [Link to this property](<#(resource)%20accounts%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) standalone: Optional\[Literal\[true]] Set to `true` and omit `unit` to create a standalone Free Account. If provided, this field must be `true`. [Link to this property](<#(resource)%20accounts%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20standalone%20%3E%20(schema)>)
type: Optional\[Literal\["standard", "enterprise"]] One of the following: "standard" Link to this property "enterprise" Link to this property
[Link to this property](<#(resource)%20accounts%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>)
unit: Optional\[Unit] Information related to the tenant unit. Provide its ID and omit standalone to create the Account within an Organization. See https://developers.cloudflare.com/tenant/how-to/manage-accounts/. id: Optional\[str] Tenant unit ID Link to this property
[Link to this property](<#(resource)%20accounts%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20unit%20%3E%20(schema)>) idempotency\_key: Optional\[str] maxLength128 minLength1 [Link to this property](<#(resource)%20accounts%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20Idempotency-Key%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Account: … id: str Identifier maxLength32 minLength32 Link to this property name: str Account name maxLength100 Link to this property
type: Literal\["standard", "enterprise"] One of the following: "standard" Link to this property "enterprise" Link to this property
Link to this property created\_on: Optional\[datetime] Timestamp for the creation of the account formatdate-time Link to this property
managed\_by: Optional\[ManagedBy] Parent container details parent\_org\_id: Optional\[str] ID of the parent Organization, if one exists maxLength32 Link to this property parent\_org\_name: Optional\[str] Name of the parent Organization, if one exists Link to this property
Link to this property
settings: Optional\[Settings] Account settings abuse\_contact\_email: Optional\[str] Sets an abuse contact email to notify for abuse reports. Link to this property enforce\_twofactor: Optional\[bool] Indicates whether membership in this account requires that Two-Factor Authentication is enabled Link to this property
Link to this property
[Link to this property](<#(resource)%20accounts%20%3E%20(model)%20account%20%3E%20(schema)>) ### Create an Account Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) account = client.accounts.create( name="name", ) print(account.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } } } ```