Create account

To create your first Cloudflare account:

Once you create your account, Cloudflare will automatically send an email to your address to verify that email address.

Existing users can create additional Free accounts in the dashboard or with the API.

The following requirements apply to Free account creation:

• Your Cloudflare user must be active and at least seven days old.
• You must have the Super Administrator role on an existing account.
• You can create up to five additional Free accounts.

Use a user-owned API token or OAuth access token. Account-owned API tokens cannot create accounts.

A user-owned API token requires the User Details Read permission. An OAuth access token requires the user-details.read scope.

Set the standalone field to true and omit unit. Every Free account creation request requires exactly one valid Idempotency-Key header. Reuse the same key when retrying the same request.

curl "https://api.cloudflare.com/client/v4/accounts" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--header "Content-Type: application/json" \
	--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
	--data '{"name":"Example account","type":"standard","standalone":true}'

curl "https://api.cloudflare.com/client/v4/accounts" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_OAUTH_TOKEN" \
	--header "Content-Type: application/json" \
	--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
	--data '{"name":"Example account","type":"standard","standalone":true}'

For the complete request schema, refer to Create Account.

Use the error message to resolve common account creation failures:

Your account name defaults to <<YOUR_EMAIL_ADDRESS>>'s Account.

You may want to customize the name of this account, either to help specify its purpose or to help associate it with multiple accounts.

To change your account name:

1. In the Cloudflare dashboard, go to the Configurations page.

   Go to Configurations ↗

2. For Account Name, select Change Name.

3. Enter a new account name.

4. Select Save.

If you are creating an account for your team or a business, we recommend choosing an email alias or distribution list for your Email, such as cloudflare@example.com.

This email address is the main point of contact for your Cloudflare billing, usage notifications, and account recovery.

Refer to Account and domain management best practices for a detailed list of ways to protect your account and domain.

Once you set up an account, you have several ways to interact with Cloudflare.

If you prefer working without code, you can manage your account and domain settings through the Cloudflare dashboard ↗︎.

For those who prefer to interact with Cloudflare programmatically, you can use several methods: