Add new Booking

Production

https://{{subdomain}}.daftara.com/api2

POST

/v2/api/bookings

Creates a new booking (an appointment-style record). Provide the client, the booking date, and one or more services to book.

Each entry in InvoiceItem must reference an active bookable service — a product of type Service that has a duration configured and belongs to at least one category. A request whose services are not valid bookable services is rejected with Please Enter Valid Service.

The end time is calculated automatically from the services' durations, and the booking's staff and status are assigned automatically — you do not send them. Set Invoice.convert to 1 to immediately convert the new booking into an invoice within the same request; the response then also returns invoice_id.

The .json extension is optional and does not change the response.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Created

application/json

The booking was created. Note this endpoint returns a {code, message, id, appointment_id} object (not the standard result envelope). When Invoice.convert was 1, invoice_id is also returned; if the conversion failed, an error message is returned instead of invoice_id.

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

cURL

Create bookingCreate and convert to invoice

curl --location --globoff 'https://.daftara.com/api2/v2/api/bookings' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data '{
    "booking": {
        "client_id": 1
    },
    "booking_items": [
        {
            "service_id": 13,
            "is_waiting": 0,
            "start_date_time": "2026-07-21 04:30",
            "duration": 60,
            "unit_price": 60,
            "discount": 0,
            "discount_type": 1,
            "sales_person_id": "1",
            "booking_package_id": ""
        }
    ]
}'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "The Booking has been saved",
    "id": "456",
    "appointment_id": "4",
    "invoice_id": "461"
}

Get Single Booking

Delete booking