---
title: "Add new booking"
method: POST
path: "/api/v2/organizations/{orgSlug}/bookings"
tags: ["Bookings"]
---

# Add new booking

`POST /api/v2/organizations/{orgSlug}/bookings`

Option 1 - Create a booking associated only with a member.             You can the associate the booking with a company as well. 
            Option 2 - Create a booking associated only with a company.             You can the associate the booking with a member as well. 

 Required scopes: `flex.space.bookings.create`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `isSilent` boolean
- `enforceBookingPolicy` boolean

## Request body

- AddBookingRequestDto
  - `properties` object — An object that contains all custom properties that can be applied to the item.
  - `start` string, required — The start date of the booking.
  - `end` string, required — The end date of the booking.
  - `resource` string, required — The _id of the resource associated with the booking.
  - `description` string — The description of the booking.
  - `title` string — The title of the booking.
  - `isTentative` boolean — Determines whether the booking is confirmed or not.
  - `serviceSlots` object — Determines whether the booking has buffer slots before and after.
  - `extras` object[] — Contains all the extra fees associated with the booking. You can enter the id of the one-off that will be used as an extra and its quantity.
  - `isFree` boolean — Determines whether the booking is free or not.
  - `member` string — The _id of the member associated with the booking.
  - `company` string — The _id of the company associated with the booking.
  - `members` string[] — An array containing a list of all the _ids of teammates associated with the booking. This is possible if the member associated with the booking is part of a company - these company members can be added here.
  - `visitors` string[] — An array containg a list of all the _ids of external visitors associated with the booking.
  - `recurrence` object — Determines the recurrence rules for the booking.
  - `source` string — Shows where the booking was created

## Response `201`

- BookingResultDto
  - `properties` object — An object that contains all custom properties that can be applied to the item.
  - `_id` string — The _id of the booking.
  - `timezone` string — The timezone of the booking.
  - `start` string — The start date of the booking.
  - `end` string — The end date of the booking.
  - `recurrence` BookingRecurrenceResultDto
    - `rrule` string — The recurrence rule for the booking.
    - `exdates` string[] — The dates that are marked as an exception from the recurrence.
  - `seriesStart` string — The start date of the series or standalone booking. For recurring bookings, this refers to the start of the entire series
  - `seriesEnd` string — The end date of the series or standalone booking. For recurring bookings, this refers to the end of the last occurrence.
  - `location` string — The _id of the location of booking.
  - `company` string — Reference to the company.
  - `member` string — Reference to the member.
  - `resource` string — Reference to the booked resource.
  - `fees` BookingFeeResultDto[] — Array of items describing how the booking will be charged for.
    - `date` string, date-time — The date of the occurrence the fee has been generated for.
    - `fee` string — The actual charge generated for this occurrence.
    - `extraFees` string[] — Array of fees generated for the extras.
    - `passes` string[] — Array of passes used for this occurrence.
    - `credits` BookingCreditsResultDto[] — The credits used for the booking.
      - `count` number — The number of credits used for the booking.
      - `credit` string — The _id of the set of credits used for the booking.
    - `coins` BookingCoinResultDto[] — The coins used for the booking.
      - `_id` string — The _id of the coin used for the fee.
      - `count` number — The count of the coins used for the fee.
    - `customPrice` number — Used if you want to set a custom price for the booking and ignore the standard rate. Can also be used a in PUT request to update an existing booking.
  - `reference` string — The reference id of the booking.
  - `isCancelled` boolean — Whether the booking got canceled or not.
  - `title` string — Booking title/summary.
  - `rate` string — Reference to the resource rate used for the booking.
  - `description` string — Long description of the booking.
  - `isTentative` boolean — True if the booking is not confirmed. Tentative bookings are not charged.
  - `isFree` boolean — True if the booking is marked as free. If create a booking marked as free, no fees will be added for it.
  - `isAccounted` boolean — True if the booking is marked as accounted.
  - `extras` object[] — Extras that are added to the booking.
  - `visitors` string[] — An array containg a list of all the ids of external visitors associated with the booking.
  - `members` string[] — An array containing a list of all the _ids of teammates associated with the booking. This is possible if the member associated with the booking is part of a company - these company members can be added here.
  - `serviceSlots` BookingServiceSlotResultDto
    - `before` number — The amount of buffer time before the booking in minutes.
    - `after` number — The amount of buffer time after the booking in minutes.
  - `source` string — Shows where the booking was created
  - `createdAt` string — The date when the booking has been created.
  - `createdBy` string — The user that created the booking.
  - `modifiedAt` string — The date of the last update of the booking.
  - `modifiedBy` string — The user that did the last modification to the booking. If no update is made this field will match the createdBy field.

---

[API](https://skmtc.dev/officernd/apis/authentication-api.md) · [All operations](https://skmtc.dev/officernd/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/officernd/authentication-api/revisions/6bcd33dc648e/schema)