> ## Documentation Index
> Fetch the complete documentation index at: https://www.carstoragesoftware.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Events and schedule

> How event types, scheduled events, walkthroughs, statuses, and the schedule fit together.

An **event** is anything that happens to a car, a customer, or the building: a drop-off, a pick-up, a detail, a transport, a pest-control visit. Events are how work gets planned, assigned, done, and recorded. The **schedule** is the calendar of all of them.

## Key terms

* **Event type** — A kind of event you've set up, such as **Vehicle Drop Off** or **Internal Service**. It controls what staff must capture and what happens on completion. Every new facility starts with a standard set (below), and you can rename, hide, or add your own.
* **Event** — One scheduled or completed occurrence of an event type: a date and time, a car or customer, assignees, and a status. The API and some screens call it an *appointment*.
* **Scope** — Whether an event type is about a **vehicle**, a **customer**, or the **facility** (for example, Facility Inspection doesn't need a car).
* **Walkthrough** — The steps staff go through when they run an event: photos, odometer, fuel, tire pressure, engine start, checklist, notes, and signature. Each one can be required, optional, or hidden per event type. The result is saved on the car as a condition report.
* **Checklist** — A list of tasks per event type that staff tick off during the walkthrough.
* **Workflow** — A multi-step job, such as intake → detail → park, that runs several events in order. Workflows appear on **Create event** next to event types.
* **Assignees and watchers** — Staff members, staff groups, or vendors responsible for an event, and people who just want updates.
* **Status** — Where an event is: Scheduled, Pending approval, In progress, Completed, Cancelled, or No-show.
* **Custom statuses** — Optional per-event-type steps (for example, "Waiting on parts") that each map to **To Do**, **In Progress**, **Blocked**, or **Done**. They drive the **Progress** view on the schedule.
* **Booking request** — An event a customer asks for in the portal. Event types that need approval arrive as **Pending approval** until staff accept or decline them.
* **Recurring event** — An event that repeats daily, weekly, every two weeks, monthly, quarterly, or yearly.
* **Bookable resource** — A bay, lift, room, or piece of equipment that can only be used by one event at a time.

### Standard event types

| For vehicles | For the facility |
| - | - |
| New Car Intake, Vehicle Drop Off, Vehicle Pick Up, Vehicle Swap, Vehicle Transport, Moved Parking Spot, Dealer Service, Internal Service, Other | Facility Inspection, Facility Maintenance, Pest Control, General Facility Event, Calendar Block, Quick Task |

## How events connect to everything else

| Linked record | What happens |
| - | - |
| Car | Photos, readings, and notes from the walkthrough are saved on the car. |
| Parking | An event type can assign a spot when it's completed (drop-off) or free it (pick-up). |
| Billing | An event type can add a charge to the customer's next bill, or update the recurring plan when a car arrives or leaves. |
| Contracts | An event type can require a signature, and a contract can include an event-scheduling field. |
| Inbox and notifications | Customers and staff can get confirmations and reminders per event type. |
| Portal | Customers see their upcoming and past events, and can book event types you've opened to them. |

## The schedule

**Schedule** shows every event. Views include **Month**, **2 weeks**, **Agenda**, **Table**, **Whiteboard**, and **Progress**, and you can filter by event type, assignee, location, and status. A full-screen display mode is built for a TV in the shop, and a calendar feed lets staff see events in Google or Apple Calendar.

## Common setups

* **Drop-off** — Vehicle Drop Off requires photos, mileage, fuel, and a customer signature, assigns a parking spot, and starts or updates the storage plan.
* **Pick-up** — Customers book Vehicle Pick Up in the portal. Completing it frees the spot.
* **Detail** — Internal Service with a checklist and custom statuses, assigned to the detail crew staff group, with the charge added to the next bill.
* **Building upkeep** — Facility Inspection and Pest Control as recurring facility events.

## Related how-tos

* [Create an appointment](https://www.carstoragesoftware.com/docs/schedule/create-an-event.md)
* [Configure event types](https://www.carstoragesoftware.com/docs/events/create-an-event-type.md)
* [Set up event checklists](https://www.carstoragesoftware.com/docs/events/set-up-the-event-walkthrough.md)
* [Approve or decline customer booking requests](https://www.carstoragesoftware.com/docs/schedule/approve-or-decline-customer-booking-requests.md)
* [Run event workflow from schedule](https://www.carstoragesoftware.com/docs/schedule/run-an-event.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.