---
title: "Create Catalog"
method: POST
path: "/data/projects/{projectId}/catalogs"
tags: ["Data -- Catalogs"]
---

# Create Catalog

`POST /data/projects/{projectId}/catalogs`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/catalogs`
- Auth: HTTP bearer

Creates a new catalog in the specified project. A catalog represents a connected data source — such as Airtable, Stripe, or Google Sheets — that exposes its schemas and tables for querying within Peaka. Requires a `name` and a `connectionId` referencing an existing connection. Some connectors accept additional `extraParameters` (e.g., Google Sheets requires specifying which sheets to include).

## Path parameters

- `projectId` string, required

## Request body

- CatalogRequest
  - `name` string: Name of the catalog
  - `connectionId` string: Connection ID. This is the ID of the connection that is used to connect to the catalog. You must create a connection before creating a catalog.
  - `extraParameters` object: Extra parameters for the catalog

## Response `200`

Catalog created successfully

- Catalog: This class represents a Catalog. It contains the id, name, display name, type, and connection ID of the catalog.
  - `id` string: The ID of the catalog.
  - `name` string: The name of the catalog.
  - `displayName` string: The display name of the catalog.
  - `catalogType` string: The type of the catalog.
  - `connectionId` string: The connection ID of the catalog.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)