Create a hub

To create a new Box Hub, call the endpoint with a title (required). You can optionally provide a description. The hub is created with default settings. To customize styling and other options, you can later use the API or Box web app.

Create hub

Box CLI

box hubs:create "HR Hub" --description "Central hub for HR policies and onboarding materials."

curl -i -X POST "https://api.box.com/2.0/hubs" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "HR Hub",
       "description": "Central hub for HR policies and onboarding materials."
     }'

await client.hubs.createHubV2025R0({
  title: hubTitle,
  description: hubDescription,
} satisfies HubCreateRequestV2025R0);

client.hubs.create_hub_v2025_r0("HR Hub", description="Central hub for HR policies and onboarding materials.")

await client.Hubs.CreateHubV2025R0Async(requestBody: new HubCreateRequestV2025R0(title: hubTitle) { Description = hubDescription });

try await client.hubs.createHubV2025R0(requestBody: HubCreateRequestV2025R0(title: hubTitle, description: hubDescription))

client.getHubs().createHubV2025R0(new HubCreateRequestV2025R0.Builder(hubTitle).description(hubDescription).build());

Request body

Field	Type	Required	Description
title	string	Yes	Title of the hub. Must not exceed 50 characters.
description	string	No	Description of the hub.

A successful response returns the new object. After creating the hub, you can see it in the Box Hubs web interface and manage its items and collaborations through the API.