Create Booking - Plugixa Car Wash

POST /plugixa-carwash/v1/bookings

Book a wash on behalf of a customer. The booking is priced on the server and given a free bay or team, exactly as the staff app does.

Needs the plugixa_carwash_create capability.

Note. A staff booking is not held to the opening hours, the time grid, the minimum notice or the booking window: any date and time is accepted as long as a suitable bay or team is free then. Use Free Times for Staff to offer only the times a customer could book.

Note. customer_id is ignored. The customer is found by email: an existing customer with that address gets the booking (and any of their empty name, phone, company or address fields are filled from it), otherwise a new customer is created.

Request

POST https://your-site.example/wp-json/plugixa-carwash/v1/bookings

Request body

Content type: application/json

The price comes from the catalogue, never from the request: package or service price, the vehicle type’s fee and any per-vehicle price, the location’s tax rate, and coupons. The duration is worked out the same way, and the bay is held for it plus the location’s buffer. Pro apps such as Memberships and Fleet accounts can change the price as well.

{
  "location_id": 3,
  "vehicle_type_id": 2,
  "package_id": 4,
  "date": "2026-11-14",
  "time": "09:00",
  "first_name": "Lucas",
  "last_name": "Bernard",
  "email": "lucas@example.com",
  "phone": "+1 217 555 0199",
  "vehicle_make": "Toyota RAV4",
  "vehicle_plate": "ABC1234",
  "staff_notes": "Regular customer"
}

Responses

201 Created. data is the new booking.

{
  "success": true,
  "data": {
    "id": 42,
    "number": "CW2026-0042",
    "form_id": null,
    "location_id": 3,
    "resource_id": 5,
    "customer_id": 25,
    "customer_vehicle_id": 31,
    "vehicle_type_id": 2,
    "package_id": 4,
    "start_at": "2026-11-14 15:00:00",
    "end_at": "2026-11-14 16:00:00",
    "blocked_until": "2026-11-14 16:10:00",
    "duration": 60,
    "status": "confirmed",
    "hold_expires_at": null,
    "first_name": "Lucas",
    "last_name": "Bernard",
    "email": "lucas@example.com",
    "phone": "+1 217 555 0199",
    "company": "",
    "vehicle_make": "Toyota RAV4",
    "vehicle_plate": "ABC1234",
    "address": "",
    "message": "",
    "agreements": [],
    "currency": "USD",
    "subtotal": 49.0,
    "discount": 0.0,
    "coupon_code": "",
    "tax": 3.06,
    "total": 52.06,
    "payment_method": "cash",
    "payment_status": "unpaid",
    "source": "staff",
    "page_url": "",
    "staff_notes": "Regular customer",
    "created_by": 1,
    "modified_by": 1,
    "created_at": "2026-11-12 09:30:00",
    "modified_at": "2026-11-12 09:30:00",
    "deleted_at": null,
    "items": [
      {
        "role": "package",
        "item_id": 4,
        "name": "Deluxe",
        "price": 49.0,
        "duration": 60
      }
    ],
    "events": [
      {
        "from": "",
        "to": "confirmed",
        "note": "Booked by staff",
        "user_id": 1,
        "created_at": "2026-11-12 09:30:00"
      }
    ],
    "next": [
      "in_progress",
      "completed",
      "cancelled",
      "no_show"
    ],
    "location": {
      "id": 3,
      "name": "Riverside"
    },
    "local_date": "2026-11-14",
    "local_time": "09:00",
    "resource": {
      "id": 5,
      "name": "Bay 1",
      "color": "#0EA5E9"
    },
    "payments": []
  }
}

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-carwash/v1/bookings" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"location_id":3,"vehicle_type_id":2,"package_id":4,"date":"2026-11-14","time":"09:00","first_name":"Lucas","last_name":"Bernard","email":"lucas@example.com","phone":"+1 217 555 0199","vehicle_make":"Toyota RAV4","vehicle_plate":"ABC1234","staff_notes":"Regular customer"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-carwash/v1/bookings');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'location_id'     => 3,
        'vehicle_type_id' => 2,
        'package_id'      => 4,
        'date'            => '2026-11-14',
        'time'            => '09:00',
        'first_name'      => 'Lucas',
        'last_name'       => 'Bernard',
        'email'           => 'lucas@example.com',
        'phone'           => '+1 217 555 0199',
        'vehicle_make'    => 'Toyota RAV4',
        'vehicle_plate'   => 'ABC1234',
        'staff_notes'     => 'Regular customer',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const auth = Buffer.from(`admin:${process.env.WP_APP_PASSWORD}`).toString('base64');
const response = await fetch('https://your-site.example/wp-json/plugixa-carwash/v1/bookings', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    location_id: 3,
    vehicle_type_id: 2,
    package_id: 4,
    date: '2026-11-14',
    time: '09:00',
    first_name: 'Lucas',
    last_name: 'Bernard',
    email: 'lucas@example.com',
    phone: '+1 217 555 0199',
    vehicle_make: 'Toyota RAV4',
    vehicle_plate: 'ABC1234',
    staff_notes: 'Regular customer',
  }),
});
const { data } = await response.json();