Create a hub - Box Dev Docs

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.

Box Hubs endpoints require the box-version: 2025.0 header. If you omit this header, the API returns a 400 error with the message Missing required box-version header. Supported API versions: [2025.0]. For more information, see Box API versioning strategy.

Create hub

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.

Last modified on September 4, 2026