create_booking

Name: Bizily
Price: 49.00 USD
Rating: 4.8 (150 reviews)

write:bookings

Create a new booking/appointment. Requires either a customerId or customer details (name + email/phone). Returns the created booking ID.

Input Parameters

Parameters

Property	Type	Description
`customerId`	`string`	Existing customer UUID (optional if creating new)
`customerName`	`string`	New customer name (required if no customerId)
`customerEmail`	`string`	Customer email address
`customerPhone`	`string`	Customer phone number
`serviceId`required	`string`	Service UUID to book
`variantId`	`string`	Service variant UUID (optional)
`startTime`required	`string`	Booking start time (ISO 8601)
`assigneeId`	`string`	Team member UUID to assign
`notes`	`string`	Booking notes (max 1000 chars)

Response

Response Schema

Property	Type	Description
`bookingId`required	`string`	Created booking UUID
`customerId`required	`string`	Customer UUID (new or existing)
`status`required	`string`	Booking status ("pending")
`startTime`required	`string`	Confirmed start time (ISO 8601)
`endTime`required	`string`	Calculated end time (ISO 8601)

Example

Requestjson

{
  "type": "tool",
  "name": "create_booking",
  "params": {
    "customerName": "Alice Brown",
    "customerEmail": "alice@example.com",
    "serviceId": "service-uuid",
    "startTime": "2024-01-25T10:00:00Z",
    "notes": "First-time customer, prefers quiet environment"
  }
}

Responsejson

{
  "success": true,
  "data": {
    "bookingId": "new-booking-uuid",
    "customerId": "new-customer-uuid",
    "status": "pending",
    "startTime": "2024-01-25T10:00:00Z",
    "endTime": "2024-01-25T11:00:00Z"
  }
}

cURL Example

curl -X POST https://app.bizily.io/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\n  "type": "tool",\n  "name": "create_booking",\n  "params": {\n    "customerName": "Alice Brown",\n    "customerEmail": "alice@example.com",\n    "serviceId": "service-uuid",\n    "startTime": "2024-01-25T10:00:00Z",\n    "notes": "First-time customer, prefers quiet environment"\n  }\n}'

Required scope: This tool requires the write:bookings scope. Make sure your API key has this permission enabled in Settings → Developer.