Skip to main content
To create a new Box Hub, call the POST /2.0/hubs 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

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."
     }'

​
Request body

FieldTypeRequiredDescription
titlestringYesTitle of the hub. Must not exceed 50 characters.
descriptionstringNoDescription of the hub.
A successful response returns the new Hub object. After creating the hub, you can see it in the Box Hubs web interface and manage its items and collaborations through the API.