---
title: "Create base"
method: POST
path: "/api/v3/meta/workspaces/{workspaceId}/bases"
tags: ["Bases"]
---

# Create base

`POST /api/v3/meta/workspaces/{workspaceId}/bases`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}/bases`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId/bases/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new base in a specified workspace. The request requires the workspace identifier in the path and base details in the request body.

## Path parameters

- `workspaceId` string, required

## Request body

- BaseCreate
  - `title` string, required: Title of the base.
  - `meta` BaseMetaReq
    - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`). **Constraints**: - Must be a valid 6-character hexadecimal color code preceded by a `#`. - Optional field; defaults to a standard color if not provided.

## Response `200`

Base was created.

- Base
  - `id` string, required: Unique identifier for the base.
  - `title` string, required: Title of the base.
  - `meta` BaseMetaRes, required
    - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`)
  - `created_at` string, date-time, required: Timestamp of when the base was created.
  - `updated_at` string, date-time, required: Timestamp of when the base was last updated.
  - `workspace_id` string, required: Unique identifier for the workspace to which this base belongs to.
  - `sources` object[]: List of data sources associated with this base. This information will be included only if one or more external data sources are associated with the base.
    - `id` string, required: Unique identifier for the data source.
    - `title` string, required: Title of the data source.
    - `type` string, required: Type of the data source (e.g., pg, mysql).
    - `is_schema_readonly` boolean, required: Indicates if the schema in this data source is read-only.
    - `is_data_readonly` boolean, required: Indicates if the data (records) in this data source is read-only.
    - `integration_id` string, required: Integration ID for the data source.

## Other responses

- `400`: Invalid request body.
- `500`: Server error.

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)