---
title: "POST /v1beta/{+parent}/instances"
method: POST
path: "/v1beta/{+parent}/instances"
tags: ["projects"]
---

# POST /v1beta/{+parent}/instances

`POST /v1beta/{+parent}/instances`

Requests that a new DatabaseInstance be created. The state of a successfully created DatabaseInstance is ACTIVE. Only available for projects on the Blaze plan. Projects can be upgraded using the Cloud Billing API https://cloud.google.com/billing/reference/rest/v1/projects/updateBillingInfo. Note that it might take a few minutes for billing enablement state to propagate to Firebase systems.

## Path parameters

- `parent` string, required

## Query parameters

- `databaseId` string
- `validateOnly` boolean

## Request body

- DatabaseInstance — Representation of a Realtime Database instance. Details on interacting with contents of a DatabaseInstance can be found at: https://firebase.google.com/docs/database/rest/start.
  - `name` string — The fully qualified resource name of the database instance, in the form: `projects/{project-number}/locations/{location-id}/instances/{database-id}`.
  - `type` 'DATABASE_INSTANCE_TYPE_UNSPECIFIED' | 'DEFAULT_DATABASE' | 'USER_DATABASE' — Immutable. The database instance type. On creation only USER_DATABASE is allowed, which is also the default when omitted.
  - `databaseUrl` string — Output only. Output Only. The globally unique hostname of the database.
  - `project` string — Output only. The resource name of the project this instance belongs to. For example: `projects/{project-number}`.
  - `state` 'LIFECYCLE_STATE_UNSPECIFIED' | 'ACTIVE' | 'DISABLED' | 'DELETED' — Output only. The database's lifecycle state. Read-only.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/firebasedatabase.md) · [All operations](https://skmtc.dev/google/apis/firebasedatabase/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/firebasedatabase/revisions/1b9d800679e0/schema)