POST /v2/bookings - Square API Reference

Create booking

POST

/v2/bookings

Creates a booking.

The required input must include the following:

Booking.location_id
Booking.start_at
Booking.AppointmentSegment.team_member_id
Booking.AppointmentSegment.service_variation_id
Booking.AppointmentSegment.service_variation_version

To call this endpoint with buyer-level permissions, set APPOINTMENTS_WRITE for the OAuth scope. To call this endpoint with seller-level permissions, set APPOINTMENTS_ALL_WRITE and APPOINTMENTS_WRITE for the OAuth scope.

For calls to this endpoint with seller-level permissions to succeed, the seller must have subscribed to Appointments Plus or Appointments Premium.

Permissions:APPOINTMENTS_WRITE

Try in API Explorer

Link to section

Request body

Example code

Link to section

idempotency_key

string

A unique key to make this request an idempotent operation.

Max Length

255

Link to section

booking

Required

The details of the booking to be created.

Link to section

Response fields

Link to section

booking

The booking that was created.

Link to section

errors

Errors that occurred during the request.

curl https://connect.squareup.com/v2/bookings \ -X POST \ -H 'Square-Version: 2024-10-17' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "booking": { "customer_id": "EX2QSVGTZN4K1E5QE1CBFNVQ8M", "start_at": "2020-11-26T13:00:00Z", "location_id": "LEQHH0YY8B42M", "appointment_segments": [ { "duration_minutes": 60, "team_member_id": "TMXUrsBWWcHTt79t", "service_variation_id": "RU3PBTZTK7DXZDQFCJHOK2MC", "service_variation_version": 1599775456731 } ] } }'

{ "booking": { "id": "zkras0xv0xwswx", "version": 0, "status": "ACCEPTED", "created_at": "2020-10-28T15:47:41Z", "updated_at": "2020-10-28T15:47:41Z", "location_id": "LEQHH0YY8B42M", "customer_id": "EX2QSVGTZN4K1E5QE1CBFNVQ8M", "customer_note": "", "seller_note": "", "start_at": "2020-11-26T13:00:00Z", "appointment_segments": [ { "duration_minutes": 60, "service_variation_id": "RU3PBTZTK7DXZDQFCJHOK2MC", "team_member_id": "TMXUrsBWWcHTt79t", "service_variation_version": 1599775456731 } ] }, "errors": [] }