---
title: "Room data model"
url: "https://docs.unified.to/calendar/room/model"
description: "The Room data model object in Unified's Room API: 17 fields, including name, capacity and location_id, with types and enum values."
date: "2026-10-25T22:23:43.518Z"
updated: "2026-10-25T22:23:43.518Z"
---
# Room data model

Updated: October 25, 2026

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/calendar/integrations.md) page. 

| Field                    | Type                                                                                    | Required | Description                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| id                       | string                                                                                  | No       |                                                                                                                                   |
| name                     | string                                                                                  | No       |                                                                                                                                   |
| capacity                 | number                                                                                  | No       |                                                                                                                                   |
| location\_id             | string                                                                                  | No       |                                                                                                                                   |
| created\_at              | string (date-time)                                                                      | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                                                                                          |
| updated\_at              | string (date-time)                                                                      | No       | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                                                                                          |
| description              | string                                                                                  | No       |                                                                                                                                   |
| type                     | enum                                                                                    | No       | Values: ROOM, DESK, OTHER                                                                                                         |
| email                    | string                                                                                  | No       | the room's calendar/mailbox address, used to invite the room to an event                                                          |
| calendar\_id             | string                                                                                  | No       | (reference to CalendarCalendar)                                                                                                   |
| floor                    | string                                                                                  | No       |                                                                                                                                   |
| timezone                 | string                                                                                  | No       |                                                                                                                                   |
| web\_url                 | string                                                                                  | No       |                                                                                                                                   |
| is\_active               | boolean                                                                                 | No       |                                                                                                                                   |
| is\_bookable             | boolean                                                                                 | No       |                                                                                                                                   |
| features                 | object                                                                                  | No       | e.g. projector, whiteboard, video conferencing                                                                                    |
| metadata                 | [CalendarMetadata](https://docs.unified.to/calendar/room/model.md#CalendarMetadata)\[\] | No       |                                                                                                                                   |
| metadata\[\].id          | string                                                                                  | No       |                                                                                                                                   |
| metadata\[\].slug        | string                                                                                  | No       |                                                                                                                                   |
| metadata\[\].value       | object                                                                                  | No       |                                                                                                                                   |
| metadata\[\].namespace   | string                                                                                  | No       |                                                                                                                                   |
| metadata\[\].format      | enum                                                                                    | No       | Values: TEXT, NUMBER, DATE, BOOLEAN, FILE, TEXTAREA, SINGLE\_SELECT, MULTIPLE\_SELECT, MEASUREMENT, PRICE, YES\_NO, CURRENCY, URL |
| metadata\[\].extra\_data | object                                                                                  | No       |                                                                                                                                   |

## TypeScript

```typescript
export type CalendarRoom = {
	id?: string;
	name?: string;
	capacity?: number;
	location_id?: string;
	raw?: any;
	created_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	description?: string;
	type?: 'ROOM' | 'DESK' | 'OTHER';
	email?: string; // the room's calendar/mailbox address, used to invite the room to an event
	calendar_id?: string; // (reference to CalendarCalendar)
	floor?: string;
	timezone?: string;
	web_url?: string;
	is_active?: boolean;
	is_bookable?: boolean;
	features?: any; // e.g. projector, whiteboard, video conferencing
	metadata?: [];
} 
```

## Zod

```typescript
import { z } from 'zod';

export const ZodCalendarRoom = z.object({
	id: z.string().optional(),
	name: z.string().optional(),
	capacity: z.number().optional(),
	location_id: z.string().optional(),
,
	created_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	updated_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	description: z.string().optional(),
	type: z.enum("ROOM", "DESK", "OTHER").optional(),
	email: z.string().optional().describe("the room's calendar/mailbox address, used to invite the room to an event"),
	calendar_id: z.string().optional().describe("(reference to CalendarCalendar)"),
	floor: z.string().optional(),
	timezone: z.string().optional(),
	web_url: z.string().optional(),
	is_active: z.boolean().optional(),
	is_bookable: z.boolean().optional(),
	features: z.unknown().optional().describe("e.g. projector, whiteboard, video conferencing"),
	metadata: z.array().optional()
});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class CalendarRoomType(str, Enum):
	ROOM = 'ROOM'
	DESK = 'DESK'
	OTHER = 'OTHER'

@dataclasses.dataclass
class CalendarRoom:
	id: Optional[str]
	name: Optional[str]
	capacity: Optional[int]
	location_id: Optional[str]

	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	description: Optional[str]
	type: Optional[CalendarRoomType]
	"""the room's calendar/mailbox address, used to invite the room to an event"""
	email: Optional[str]
	"""(reference to CalendarCalendar)"""
	calendar_id: Optional[str]
	floor: Optional[str]
	timezone: Optional[str]
	web_url: Optional[str]
	is_active: Optional[bool]
	is_bookable: Optional[bool]
	"""e.g. projector, whiteboard, video conferencing"""
	features: Optional[PropertyCalendarRoomFeatures]
	metadata: Optional[PropertyCalendarRoomMetadata]
```