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 '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

Bodyapplication/json

Example

{
    "createdAt": "2024-01-01T09:00:00.000Z",
    "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",
    "status": "accepted",
    "title": "Team Meeting",
    "type": "occurrence",
    "userId": "user-123",
    "updatedAt": "2024-01-01T09:30:00.000Z",
    "description": "Weekly team standup meeting"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409Conflict

Gets a single room

Lists room bookings