Creates a room booking

POST

/rooms/{roomId}/bookings

Creates a new booking for the specified room. Requires room ID, start time, duration (in seconds), title, description (optional), privacy flag, and optionally a user ID (null for anonymous bookings). Supports adding attendees with their email addresses. Returns the created booking with full details including all booking metadata.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "startTime": "2024-01-01T10:00:00.000Z",
    "durationInSeconds": 3600,
    "title": "Team Meeting",
    "description": "Weekly team sync meeting to discuss project updates",
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "isPrivate": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://connect.deskbird.com/rooms//bookings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "startTime": "2024-01-01T10:00:00.000Z",
    "durationInSeconds": 3600,
    "title": "Team Meeting",
    "description": "Weekly team sync meeting to discuss project updates",
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "isPrivate": false
}'

Responses

🟢201Created

application/json

Room booking created successfully

Body

Example

{
    "attendees": [
        {
            "email": "john.doe@example.com"
        }
    ],
    "durationInSeconds": 3600,
    "id": "booking-123",
    "isCheckedIn": false,
    "isPrivate": false,
    "officeId": "office-123",
    "roomId": "room-123",
    "startTime": "2024-01-01T10:00:00Z",
    "title": "Team Meeting",
    "type": "occurrence",
    "userId": "user-123",
    "description": "Weekly team standup meeting"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

Lists room bookings

Gets a single room booking