Add new bookings

post https://app.officernd.com/api/{version}/organizations/{orgSlug}/bookings

Add one or more bookings.

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

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

📘
Important
Check Settings/Platform/Calendar & Bookings for the "Make "Select Member" a required field" option to determine whether you can create bookings with a team only or if a member will always be required.

❗️
Warning
Using the API you can create a booking for any resource, so long as its "resourceId" parameter is valid.
Use the resource-types endpoint in order to check which resource types are bookable before referencing them in a booking.
This will help you prevent creating bookings for resources that aren't bookable.

Responses

Response body

array of objects

object

_id

string

The _id of the booking.

tentative

boolean

Determines whether the booking is tentative or not.

free

boolean

Determines whether the booking is free or not.

start

object

Contains the start date of the booking.

end

object

Contains the end date of the booking.

member

string

The _id of the member associated with the booking.

team

string

The _id of the team associated with the booking.

resourceId

string

The _id of the resource associated with the booking.

description

string

The description of the booking.

summary

string

The title of the booking.

serviceSlots

object

Determines whether the booking has buffer slots before and after.re

members

array of strings

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.

members

visitors

array of strings

An array containg a list of all the _ids of external visitors associated with the booking.

visitors

recurrence

object

Determines the recurrence rules for the booking.

extras

object

Contains all the extra fees associated with the booking.

Language

Credentials

OAuth2

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://app.officernd.com/api/v1/organizations/orgSlug/bookings \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
66
]
1
[
2
  {
3
    "start": {
4
      "dateTime": "2017-10-31T09:00:00.000Z"
5
    },
6
    "end": {
7
      "dateTime": "2017-10-31T11:00:00.000Z"
8
    },
9
    "resourceId": "5943b5ebb4bd93ca5f1906fc",
10
    "extras": {},
11
    "recurrence": {
12
      "rrule": null
13
    },
14
    "member": null,
15
    "visitors": [],
16
    "members": [],
17
    "team": "59493231518f3f150d306c62",
18
    "timezone": "Europe/London",
19
    "source": "admin",
20
    "plan": "5943b59eb4bd93ca5f1906f7",
21
    "fees": [
22
      {
23
        "date": "2017-10-31T00:00:00.000Z",
24
        "extraFees": [],
25
        "credits": [

Add new bookings

📘
Important

❗️
Warning

📘Important

❗️Warning

200The booking was successfully created.

400The resouce isn't available in this slot.

📘
Important

❗️
Warning