---
title: "Create Free Tier Cluster"
method: POST
path: "/v4/organizations/{organizationId}/projects/{projectId}/clusters/freeTier"
tags: ["Free Tier"]
---

# Create Free Tier Cluster

`POST /v4/organizations/{organizationId}/projects/{projectId}/clusters/freeTier`

## Request

- Base URL: `https://cloudapi.cloud.couchbase.com`
- URL: `https://cloudapi.cloud.couchbase.com/v4/organizations/{organizationId}/projects/{projectId}/clusters/freeTier`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/docs/v4/organizations/:organizationId/projects/:projectId/clusters/freeTier/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a free tier cluster.  This is a 1 node cluster than only runs data, query, index and search services.

You can have at most 1 free tier cluster per tenant.

The following features are not available for free tier clusters:
  - backup/restore
  - private endpoint service
  - network peering
  - audit logs
  - alert integration
  - CMEK
  - on/off schedule

Only cluster name, description, CSP, region and CIDR are configurable.

There are limited regions available based on CSP:
  a. for AWS they are us-east-2, eu-west-1, ap-southeast-1
  b. for GCP they are us-west1, europe-west1, asia-east1
  c. for Azure they are eastus, swedencentral, koreacentral

In order to access this endpoint, the provided API key must have at least one of the following roles:
- Organization Owner
- Project Owner
- Project Manager

To learn more, see [Organization, Project, and Database Access Overview](https://docs.couchbase.com/cloud/organizations/organization-projects-overview.html).

## Request body

- CreateFreeTierClusterRequest
  - `name` string, required: Name of the cluster (up to 256 characters).
  - `description` string: Description of the cluster (up to 1024 characters).
  - `cloudProvider` CloudProvider, required: The cloud provider where the cluster will be hosted. For information about providers and supported regions, see: - [Amazon Web Services](https://docs.couchbase.com/cloud/reference/aws.html) - [Google Cloud Platform](https://docs.couchbase.com/cloud/reference/gcp.html) - [Microsoft Azure](https://docs.couchbase.com/cloud/reference/azure.html)
    - `type` 'aws' | 'gcp' | 'azure', required: Cloud provider type. Note: For singleNode cluster, only AWS type cloud provider is allowed. 1. `aws`: Amazon Web Services 2. `gcp`: Google Cloud Platform 3. `azure`: Microsoft Azure
    - `region` string, required: Cloud provider region, for example `us-west-2`.
    - `cidr` string: CIDR block for Cloud Provider.

## Response `202`

Successfully submitted job to create a free tier cluster.

- CreateClusterResponse
  - `id` string, uuid, required: The ID of the cluster created.

## Other responses

- `403`: The client does not have the necessary permissions to access this resource.
- `404`: The requested resource was not found.
- `422`: Request validation error. For example when client tries to create more than 1 free tier cluster in tenant.
- `429`: Returned when the client exceeds the rate limit for the given APIKey.
- `500`: An unexpected error occurred in the server while processing this request.

---

[API](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api.md) - [All operations](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/revisions/a5e88bcf71cb?raw)