Docs/Workspace API/Booking Links

Booking Links

Standalone booking pages that live at /book/{slug} — created directly without provisioning an AI agent. Use mode: "simple" for a plain slot picker, or mode: "advanced" to also unlock the Advanced Booking experience (Requests / Bookings / Team tabs in Operations). Scopes: bookings.links.read / bookings.links.write / bookings.links.delete.

Endpoints

GET /api/workspace/v1/bookings/links

GET /api/workspace/v1/bookings/links/{id}

POST /api/workspace/v1/bookings/links

PATCH /api/workspace/v1/bookings/links/{id}

DELETE /api/workspace/v1/bookings/links/{id}

POST /api/workspace/v1/bookings/links/{id}/restore

The booking link object

Field	Type	Description
name*	string	Human-readable name (<= 255 chars, required)
mode*	enum	simple (single-slot booking page) or advanced (also enables the Requests/Bookings/Team tabs in the Operations pillar)
duration_minutes	integer	Slot length in minutes (5-480, default 30)
buffer_minutes	integer	Buffer between slots (0-240, default 15)
timezone	string	IANA timezone (default Europe/Amsterdam)
calendar_group_id	integer	Optional linked calendar group for availability checks
slug	string	Auto-generated public slug (read-only)
enabled	boolean	Whether the /book/[slug] page is live (read-only)

Create a simple booking link

curl "https://app.staffifyai.com/api/workspace/v1/bookings/links" \
  -X POST \
  -H "Authorization: Bearer sfy_wsp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Discovery call",
    "mode": "simple",
    "duration_minutes": 30
  }'

Create an advanced booking link

Advanced mode also unlocks the Requests / Bookings / Team tabs in the Operations pillar because the workspace's has_advanced_booking capability starts firing.

curl "https://app.staffifyai.com/api/workspace/v1/bookings/links" \
  -X POST \
  -H "Authorization: Bearer sfy_wsp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Full onboarding",
    "mode": "advanced",
    "duration_minutes": 60,
    "buffer_minutes": 15
  }'

Webhooks

booking_link.created
booking_link.updated
booking_link.deleted