---
title: "Create a hub"
method: POST
path: "/datainsights/v1.1/hubs"
tags: ["Hub"]
---

# Create a hub

`POST /datainsights/v1.1/hubs`

## Headers

- `X-PROPERTY-ID` integer, required

## Request body

- CreateHub
  - `title` string, required — Hub title
  - `description` string, nullable — Hub Description
  - `settings` CardPositioning[]
    - `i` string, required — A string corresponding to the component key
    - `x` number — X coordinate
    - `y` number — Y coordinate
    - `w` number — Width
    - `h` number — Height
    - `minW` number — Minimum width
    - `maxW` number — Maximum width
    - `minH` number — Minimum height
    - `maxH` number — Maximum height
    - `moved` boolean — Moved
    - `static` boolean — Static
    - `isDraggable` boolean — Is draggable
    - `isResizable` boolean — Is resizable
    - `resizeHandles` string[] — Resize handles
    - `isBounded` boolean — Is bounded

## Response `201`

Created

- Hub
  - `id` integer, required — Hub Id
  - `title` string, required — Hub title
  - `description` string, nullable — Hub Description
  - `cards` Card[]
    - `id` integer, required — Card Id
    - `hub_id` integer, required — Hub id
    - `chart_id` integer, required — Chart id
  - `property_id` integer, required — Property id
  - `settings` CardPositioning[]
    - `i` string, required — A string corresponding to the component key
    - `x` number — X coordinate
    - `y` number — Y coordinate
    - `w` number — Width
    - `h` number — Height
    - `minW` number — Minimum width
    - `maxW` number — Maximum width
    - `minH` number — Minimum height
    - `maxH` number — Maximum height
    - `moved` boolean — Moved
    - `static` boolean — Static
    - `isDraggable` boolean — Is draggable
    - `isResizable` boolean — Is resizable
    - `resizeHandles` string[] — Resize handles
    - `isBounded` boolean — Is bounded
  - `created_at` string, date-time — Created at timestamp of the hub
  - `updated_at` string, date-time — Updated at timestamp of the hub
  - `created_by` User
    - `id` integer
    - `name` string
    - `email` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)