Calendar
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:
- Resolves the staff group from case_id (or defaults to first Office group)
- Checks if the call is a test call - if so, returns mock data without booking
- Checks which members of the staff group are available at the requested time
- Randomly selects one available member
- 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.
post/calendars/book-meeting
Request body
Response
Successful Response
Changes
No recorded changes to this endpoint across all 1 revision of this API.