Skip to content
HeadlessWP Pro

Create booking

id: fluent-booking-bookings-create owner: fluent-booking method: POST path: /wp-json/headlesswp/v1/bookings title: Create booking usedBySite: false

POST /wp-json/headlesswp/v1/bookings

Creates a booking through FluentBooking.

Auth + CSRF

  • Auth: public (permission_callback is __return_true).
  • Proxy nonce required: no.
  • CSRF: exempt (not WP nonce-based).
  • For guests, successful responses may include booking.manageToken and booking.manageTokenExpiresAt for later manage actions.

Request schema

  • JSON body is validated by validateCreateBookingRequest; unknown top-level fields are rejected.

Response schema

{
  "data": {
    "booking": {
      "bookingId": "string | number",
      "manageToken": "string (guest flows only)",
      "manageTokenExpiresAt": "string (guest flows only)"
    }
  }
}

Error codes

  • VALIDATION_FAILED (422)
  • RATE_LIMITED (429)
  • DEPENDENCY_UNAVAILABLE (503)
  • BOOKING_SLOT_UNAVAILABLE (409)
  • BOOKING_CREATE_FAILED (500)