# Create

Launch stage: Public Preview

`POST /api/2.0/database/catalogs`

Create a Database Catalog.

API scopes: postgres

## Request body

- `catalog` (object, optional)
  - `name` (string, optional)
    The name of the catalog in UC.
  - `database_instance_name` (string, optional)
    The name of the DatabaseInstance housing the database.
  - `database_name` (string, optional)
    The name of the database (in an instance) associated with the catalog.
  - `uid` (string, optional)
  - `create_database_if_not_exists` (boolean, optional)

## Returns

Returns the DatabaseCatalog object.

## Response

```json
{
  "name": "string",
  "database_instance_name": "string",
  "database_name": "string",
  "uid": "string",
  "create_database_if_not_exists": true
}
```