Create Booking Form - Plugixa Car Parking

POST /plugixa-car-parking/v1/booking-forms

Create a booking form: which locations and space types it offers, the steps the customer walks through, its look, and the extra questions it asks.

The signed-in user needs the plugixa_carparking_create capability (create records).

Note. The first form created on a site becomes the default form even without is_default. Sending is_default: true makes the new form the default and takes the flag off every other form.

Request

POST https://your-site.example/wp-json/plugixa-car-parking/v1/booking-forms

Request body

Content type: application/json

Steps

Each step is {"key": "...", "enabled": true, "options": {...}}.

dates is always moved first and confirm last; the rest keep the order sent. The payment step is only shown when the site offers two or more payment methods. A form with no enabled step runs dates, space, details and confirm.

Fields

Each extra question is {"key": "...", "label": "...", "type": "...", "required": false, "options": []}.

{
  "name": "Airport parking",
  "location_ids": [4],
  "steps": [
    { "key": "dates", "enabled": true },
    { "key": "space", "enabled": true, "options": { "coupon": false } },
    { "key": "details", "enabled": true },
    { "key": "confirm", "enabled": true }
  ],
  "fields": [
    { "key": "flight_number", "label": "Flight number", "type": "text", "required": true }
  ],
  "style": { "primary_color": "#0f766e", "design": "split" }
}

Responses

201 Created. data is the new form.

{
  "success": true,
  "data": {
    "id": 3,
    "name": "Airport parking",
    "slug": "airport-parking",
    "status": "active",
    "steps": [
      { "key": "dates", "enabled": true, "options": [] },
      { "key": "space", "enabled": true, "options": { "coupon": false } },
      { "key": "details", "enabled": true, "options": [] },
      { "key": "confirm", "enabled": true, "options": [] }
    ],
    "style": { "primary_color": "#0f766e", "design": "split" },
    "location_ids": [4],
    "space_type_ids": null,
    "is_default": false,
    "settings": {
      "fields": [
        { "key": "flight_number", "label": "Flight number", "type": "text", "required": true, "options": [] }
      ]
    },
    "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,
    "fields": [
      { "key": "flight_number", "label": "Flight number", "type": "text", "required": true, "options": [] }
    ],
    "all_locations": false,
    "location_names": ["Terminal 2"],
    "space_type_names": []
  }
}

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/plugixa-car-parking/v1/booking-forms" \
  -u "admin:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"name":"Airport parking","location_ids":[4],"steps":[{"key":"dates","enabled":true},{"key":"space","enabled":true,"options":{"coupon":false}},{"key":"details","enabled":true},{"key":"confirm","enabled":true}],"fields":[{"key":"flight_number","label":"Flight number","type":"text","required":true}],"style":{"primary_color":"#0f766e","design":"split"}}'

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-car-parking/v1/booking-forms');
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([
        'name'         => 'Airport parking',
        'location_ids' => [4],
        'steps'        => [
            ['key' => 'dates', 'enabled' => true],
            ['key' => 'space', 'enabled' => true, 'options' => ['coupon' => false]],
            ['key' => 'details', 'enabled' => true],
            ['key' => 'confirm', 'enabled' => true],
        ],
        'fields'       => [
            ['key' => 'flight_number', 'label' => 'Flight number', 'type' => 'text', 'required' => true],
        ],
        'style'        => ['primary_color' => '#0f766e', 'design' => 'split'],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-car-parking/v1/booking-forms', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Airport parking',
    location_ids: [4],
    steps: [
      { key: 'dates', enabled: true },
      { key: 'space', enabled: true, options: { coupon: false } },
      { key: 'details', enabled: true },
      { key: 'confirm', enabled: true },
    ],
    fields: [
      { key: 'flight_number', label: 'Flight number', type: 'text', required: true },
    ],
    style: { primary_color: '#0f766e', design: 'split' },
  }),
});
const { data } = await response.json();