TBBNSpaceDocs
Getting started

From zero to a booked room

The Space API works on your own Spaces. Set them up once on space.tbbnetwork.com, then list and book them from your own systems with a key that sees only your Business's Spaces.

1. Set up your Spaces

Create a Business at business.tbbnetwork.com, add your locations, and add each room or desk on space.tbbnetwork.com with its opening hours and capacity. Choose API only for rooms you don't want on the public site.

2. Get an API key

Create a key at account.tbbnetwork.com → Space API keys. Leave Bookings made with this key on Free internal reservations for your own team, or choose Charge the person booked if you rent your Spaces out.

3. List your Spaces

curl
curl "https://api.tbbnetwork.com/v1/space/search?query=board" \ -H "Authorization: Bearer sk_space_live_..."

4. Book a room

Pass the id of the Space and externalClientRef — your identifier for who it's for. An internal reservation is confirmed at once and comes back with a bookingUrl you can send them.

POST /v1/space/bookings
curl -X POST https://api.tbbnetwork.com/v1/space/bookings \
  -H "Authorization: Bearer sk_space_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "space_...",
    "serviceType": "WORKSPACE",
    "scheduledAt": "2026-10-12T14:00:00Z",
    "durationMinutes": 60,
    "externalClientRef": "employee-042"
  }'

Next steps