JAjammed-org
Booking - Core

Create a booking

Changed on

Create a new booking on Jammed as an admin.

This creates a booking in the same way as a staff member would from the admin dashboard.

You must provide booking_details with at least a start_at, end_at, room_id, and price.

For the customer, you can either:

  • Provide a customer_id to book for an existing customer
  • Provide customer_details with name and email to create a new customer inline

Optionally provide band_details with a name to associate a group/band, and extra_ids to add extras to the booking.

The booking is created with source manually_added and platform api_v2.

post/bookings.json

Request

  • Base URL
    https://api.jammed.app/api/v2
  • Auth
    none declared. Required headers: Authorization

Headers

Authorizationstring required

Request body

Example request

{
  "booking": {
    "booking_details": {
      "start_at": "2026-03-01T10:00:00Z",
      "end_at": "2026-03-01T14:00:00Z",
      "price": 6000
    }
  }
}

Response

Booking created

codestring

The code of the booking - seen by customers on the booking page

idstring

Same as code

recordingboolean

Whether the room has been marked as a recording

regularboolean

Whether the booking is part of a regular booking

online_bookingboolean

Whether the booking was made online by the customer

created_atinteger

Unix timestamp from epoch

updated_atinteger

Unix timestamp from epoch

approved_atinteger

Unix timestamp from epoch - when the booking was approved (if approved)

rejected_atinteger

Unix timestamp from epoch - when the booking was rejected (if rejected)

priceinteger

The price of the booking time only in cents/pence/units

price_currencystring

The currency of the price

titlestring

The title of the booking - this is generated from the customer and group names

start_atinteger

Unix timestamp from epoch

end_atinteger

Unix timestamp from epoch

durationinteger

The duration of the booking in seconds

duration_hoursnumber

The duration of the booking in hours, e.g. 1pm-2.30pm = 2.5 hours

duration_full_hoursinteger

The duration of the booking in hours, rounded up to each full hour, e.g. 1pm-2.30pm = 3 hours

activity_namestring

The name of the activity the booking is part of - e.g. 'Rehearsal'

datesstring[]

The dates that the booking is part of in local time - given as strings YYYYMMDD format

timezonestring

The timezone of the booking

has_amount_dueboolean

Whether the booking still has an amount due

remaining_amountinteger

The remaining amount due for the booking

cancelledboolean

Whether the booking has been cancelled

taken_bystring

The name of the staff member who took the booking - if null, the booking was made by the customer themselves

Example response

{
  "cancellation_link": {
    "url": "https://studio.jammed.app/reserved?booking=ABC123&hash=...&validation=...",
    "expires_at": 1762352400
  }
}

Changes