Create Booking - Plugixa Chauffeur

POST /plugixa-chauffeur/v1/bookings

Create a booking from your own data, the way staff enter a phone booking in the admin.

Needs a signed-in user with the plugixa_chauffeur_manage capability (administrators have it after activation).

Note. This endpoint stores what you send. It does not calculate the fare, does not run pricing rules, does not check availability or the vehicle’s seats, and sends no booking e-mails. To take a booking with all of that, use Place Booking.

Request

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

Request body

Content type: application/json

Every field is optional: an empty body creates a pending booking with nothing in it. booking_number is generated for you. price_total cannot be sent: it is the sum of price_base, price_distance and price_time. Only the JSON body is read; form-encoded fields are ignored.

{
  "status": "processing",
  "service_type": "distance",
  "transfer_type": "one_way",
  "booking_form_id": 1,
  "vehicle_id": 3,
  "pickup_address": "Paris Charles de Gaulle Airport, Terminal 2E",
  "dropoff_address": "Hotel Lutetia, 45 Boulevard Raspail, Paris",
  "pickup_datetime": "2026-11-20 14:30:00",
  "distance_km": 32.5,
  "passengers": 2,
  "luggage": 3,
  "customer_name": "Claire Martin",
  "customer_email": "claire.martin@example.com",
  "customer_phone": "+33 6 12 34 56 78",
  "price_base": 20,
  "price_distance": 58.5,
  "currency": "EUR",
  "payment_method": "cash"
}

Responses

200 Created. data is the new booking.

A create answers 200, not 201.

{
  "success": true,
  "message": "",
  "data": {
    "id": "42",
    "booking_number": "PXC-20261112-0815",
    "booking_form_id": 1,
    "service_type": "distance",
    "transfer_type": "one_way",
    "status": "processing",
    "vehicle_id": 3,
    "driver_id": null,
    "pickup_address": "Paris Charles de Gaulle Airport, Terminal 2E",
    "pickup_lat": null,
    "pickup_lng": null,
    "dropoff_address": "Hotel Lutetia, 45 Boulevard Raspail, Paris",
    "dropoff_lat": null,
    "dropoff_lng": null,
    "pickup_datetime": "2026-11-20 14:30:00",
    "return_datetime": null,
    "duration_hours": null,
    "distance_km": 32.5,
    "travel_minutes": null,
    "passengers": 2,
    "luggage": 3,
    "customer_name": "Claire Martin",
    "customer_email": "claire.martin@example.com",
    "customer_phone": "+33 6 12 34 56 78",
    "notes": null,
    "price_base": 20.0,
    "price_distance": 58.5,
    "price_time": 0.0,
    "price_total": 78.5,
    "currency": "EUR",
    "payment_method": "cash",
    "payment_status": "unpaid",
    "payment_reference": null,
    "created_at": "2026-11-12 09:30:00",
    "modified_at": null,
    "vehicle_name": "Mercedes E-Class",
    "driver_name": null
  }
}

Ids and the columns this endpoint does not convert come back as strings, exactly as the database returns them: compare them as strings or convert them.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-chauffeur/v1/bookings" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"status":"processing","service_type":"distance","transfer_type":"one_way","booking_form_id":1,"vehicle_id":3,"pickup_address":"Paris Charles de Gaulle Airport, Terminal 2E","dropoff_address":"Hotel Lutetia, 45 Boulevard Raspail, Paris","pickup_datetime":"2026-11-20 14:30:00","distance_km":32.5,"passengers":2,"luggage":3,"customer_name":"Claire Martin","customer_email":"claire.martin@example.com","customer_phone":"+33 6 12 34 56 78","price_base":20,"price_distance":58.5,"currency":"EUR","payment_method":"cash"}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-chauffeur/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([
        'status'          => 'processing',
        'service_type'    => 'distance',
        'transfer_type'   => 'one_way',
        'booking_form_id' => 1,
        'vehicle_id'      => 3,
        'pickup_address'  => 'Paris Charles de Gaulle Airport, Terminal 2E',
        'dropoff_address' => 'Hotel Lutetia, 45 Boulevard Raspail, Paris',
        'pickup_datetime' => '2026-11-20 14:30:00',
        'distance_km'     => 32.5,
        'passengers'      => 2,
        'luggage'         => 3,
        'customer_name'   => 'Claire Martin',
        'customer_email'  => 'claire.martin@example.com',
        'customer_phone'  => '+33 6 12 34 56 78',
        'price_base'      => 20,
        'price_distance'  => 58.5,
        'currency'        => 'EUR',
        'payment_method'  => 'cash',
    ]),
]);
$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-chauffeur/v1/bookings', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    status: 'processing',
    service_type: 'distance',
    transfer_type: 'one_way',
    booking_form_id: 1,
    vehicle_id: 3,
    pickup_address: 'Paris Charles de Gaulle Airport, Terminal 2E',
    dropoff_address: 'Hotel Lutetia, 45 Boulevard Raspail, Paris',
    pickup_datetime: '2026-11-20 14:30:00',
    distance_km: 32.5,
    passengers: 2,
    luggage: 3,
    customer_name: 'Claire Martin',
    customer_email: 'claire.martin@example.com',
    customer_phone: '+33 6 12 34 56 78',
    price_base: 20,
    price_distance: 58.5,
    currency: 'EUR',
    payment_method: 'cash',
  }),
});
const { data } = await response.json();