kokoro.be

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "number",
      "description": "Service ID from getBookingCatalog"
    },
    "staffId": {
      "type": "number",
      "description": "Staff ID from getBookingCatalog. Use -1 for no preference (any available staff)."
    },
    "slotStart": {
      "type": "string",
      "description": "Appointment start time in 'YYYY-MM-DD HH:mm' format, as returned by getServiceAvailability"
    },
    "client": {
      "type": "object",
      "properties": {
        "firstName": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "email": {
          "type": "string",
          "description": "Client email — required to send the booking confirmation"
        },
        "mobilePhoneNumber": {
          "type": "string",
          "description": "Client phone in E.164 format (e.g. +15145551234). Optional but recommended for SMS reminders."
        },
        "additionalRequest": {
          "type": "string",
          "description": "Special instructions or notes for the merchant"
        }
      },
      "required": [
        "firstName",
        "lastName",
        "email"
      ]
    },
    "lang": {
      "type": "string",
      "description": "Optional BCP-47 language code (e.g. 'fr', 'en'). If omitted, the user's browser language is used automatically. Only pass this to override the browser's detected locale."
    }
  },
  "required": [
    "serviceId",
    "staffId",
    "slotStart",
    "client"
  ]
}