Box Developer Documentation
Log in
Beta

Create hub

post
https://api.box.com/2.0
/hubs

Creates a new Hub.

Request

bearer [ACCESS_TOKEN]
application/json

Request Headers

stringin headerrequired

Version header.

Value is always 2025.0

Request Body

stringin bodyoptional
"This is a description of the Hub."

Description of the Hub.

stringin bodyrequired
"Hub Title"
50

Title of the Hub. It cannot be empty and should be less than 50 characters.

Response

application/jsonHub

Returns a new Hub object.

application/jsonClient error

Returned if any of the request parameters are not valid.

application/jsonClient error

Returns an error when the user does not have the right permissions to create a Hub.

application/jsonClient error

An unexpected client error.

post
Create hub
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

TypeScript Gen
await client.hubs.createHubV2025R0({
  title: hubTitle,
  description: hubDescription,
} satisfies HubCreateRequestV2025R0);
Python Gen
client.hubs.create_hub_v2025_r0(hub_title, description=hub_description)
.NET Gen
await client.Hubs.CreateHubV2025R0Async(requestBody: new HubCreateRequestV2025R0(title: hubTitle) { Description = hubDescription });
Swift Gen (Beta)
try await client.hubs.createHubV2025R0(requestBody: HubCreateRequestV2025R0(title: hubTitle, description: hubDescription))
Java Gen (Beta)
client.getHubs().createHubV2025R0(new HubCreateRequestV2025R0.Builder(hubTitle).description(hubDescription).build())

Response Example

{
  "id": "12345",
  "type": "hubs",
  "can_non_owners_invite": true,
  "can_shared_link_be_created": true,
  "created_at": "2012-12-12T10:53:43Z",
  "created_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "description": "All the contracts for the company.",
  "is_ai_enabled": true,
  "is_collaboration_restricted_to_enterprise": true,
  "title": "Contracts",
  "updated_at": "2012-12-12T10:53:43Z",
  "updated_by": {
    "id": "11446498",
    "type": "user",
    "login": "ceo@example.com",
    "name": "Aaron Levie"
  },
  "view_count": 506
}