---
title: "Book Meeting"
method: POST
path: "/calendars/book-meeting"
tags: ["Calendar"]
---

# Book Meeting

`POST /calendars/book-meeting`

Book a meeting with a staff group at a specific time slot.

This endpoint is authenticated using a service token (Bearer token in Authorization header).

This endpoint:
1. Resolves the staff group from case_id (or defaults to first Office group)
2. Checks if the call is a test call - if so, returns mock data without booking
3. Checks which members of the staff group are available at the requested time
4. Randomly selects one available member
5. Books the meeting on that member's calendar

- **call_id**: The ID of the call (required to determine if this is a test call)
- **case_id**: Optional ID of case to get assigned staff group (defaults to first Office group)
- **first_name**: Client's first name
- **last_name**: Client's last name
- **phone_number**: Client's phone number
- **email**: *(deprecated)* Optional client's email address
- **time_slot**: The desired meeting time (datetime with timezone)

Returns:
    Information about the booked meeting including the assigned staff member.

## Request body

- BookMeetingRequest — Request model for booking a meeting
  - `call_id` string, uuid, required
  - `case_id` string, uuid, nullable
  - `first_name` string, required
  - `last_name` string, required
  - `phone_number` string, required
  - `email` string, nullable
  - `time_slot` string, date-time, required
  - `attendee_timezone` string, required

## Response `201`

Successful Response

- BookMeetingResponse — Response model for booking a meeting
  - `message` string, required
  - `staff_group_id` string, uuid, required
  - `assigned_user_id` string, uuid, required
  - `assigned_user_name` string, required
  - `time_slot` string, required
  - `meeting_duration_minutes` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)