---
title: "The Appointments facade — Appointments for Laravel | Roundly"
description: "Tour the Appointments facade — the schedule() builder, DTO creates, the for() handle with participants(), availability, ICS feeds and previews."
url: https://roundly-consulting.com/open-source/docs/appointments-for-laravel/facade
language: en
---

[All packages](https://roundly-consulting.com/open-source.md)

[Appointments for Laravel](https://roundly-consulting.com/open-source/docs/appointments-for-laravel.md)

# The Appointments facade

Everything goes through RoundlyConsulting\\Appointments\\Facades\\Appointments. Its root is AppointmentManager, a container singleton you can also inject (see DI and actions). schedule(), create() and createRecurring() write new bookings, for($appointment) scopes every change to one booking, and the read methods answer availability and export questions without writing anything:

```php
use Carbon\CarbonImmutable;
use RoundlyConsulting\Appointments\DataTransferObjects\RecurrenceData;
use RoundlyConsulting\Appointments\Enums\Frequency;
use RoundlyConsulting\Appointments\Enums\Status;
use RoundlyConsulting\Appointments\Facades\Appointments;

// Create
$appointment = Appointments::schedule('Consultation')->startingAt('2026-07-01 09:00')->lasting(45)->create();
$appointment = Appointments::create($appointmentData);             // from an AppointmentData
$series = Appointments::createRecurring($appointmentData, $rule);  // Collection<int, Appointment>

// One booking
$booking = Appointments::for($appointment);                        // AppointmentHandle
$booking->reschedule(CarbonImmutable::parse('2026-07-02 10:00'));  // keeps the duration
$booking->confirm();                                               // or cancel(), complete(), decline(), markNoShow()
$booking->transition(Status::Completed);
$booking->participants()->add($user);                              // AppointmentParticipants
$booking->ics();                                                   // one-event calendar

// Reads — nothing is written
Appointments::isAvailable($doctor, $start, $end);                  // bool
Appointments::conflicts($doctor, $start, $end);                    // Collection<int, Appointment>
Appointments::ics($user->appointments()->upcoming()->get());       // one VCALENDAR, many VEVENTs
Appointments::occurrences($start, new RecurrenceData(Frequency::Weekly, count: 4)); // list<CarbonImmutable>

// Tests
$fake = Appointments::fake();                                      // AppointmentsFake
```

## Method reference

| Method | Returns |
| --- | --- |
| `schedule(string $name)` | AppointmentBuilder — chain the builder methods, then create() or createRecurring(). |
| `create(AppointmentData $data)` | Appointment. |
| `createRecurring(AppointmentData $data, ?RecurrenceData $rule = null)` | Collection<int, Appointment> — the rule falls back to the DTO’s own recurrence; with none, a single-item collection. |
| `for(Appointment $appointment)` | AppointmentHandle — reschedule(), transition(), confirm(), cancel(), complete(), decline(), markNoShow(), participants(), ics(). |
| `for($appointment)->participants()` | AppointmentParticipants — add(), remove(), has(), all(). |
| `conflicts(Model $participant, $start, $end, ?Appointment $ignore = null)` | Collection<int, Appointment> — the participant’s overlapping bookings. |
| `isAvailable(Model $participant, $start, $end, ?Appointment $ignore = null)` | bool — free for the whole window. |
| `ics(iterable $appointments)` | string — one VCALENDAR with a VEVENT per appointment. |
| `occurrences(CarbonInterface $start, RecurrenceData $rule)` | list<CarbonImmutable> — a rule’s start times, nothing written. |
| `fake()` | AppointmentsFake — see Testing. |

## The for() handle

Appointments::for($appointment) returns an AppointmentHandle bound to that booking. reschedule() keeps the duration unless you pass one and fires AppointmentRescheduled; transition() and the confirm()-style shortcuts run the guarded status machine; participants() returns an AppointmentParticipants scoped to the booking, with add(), remove(), has() and all(); ics() renders the booking as a one-event calendar.

## Model shortcuts

The Appointment model’s confirm(), cancel(), complete(), decline(), markNoShow(), transitionTo() and toIcs() are sugar over the same handle — they call for($this) on the manager, so a host override and Appointments::fake() see them too.

- Every write — facade, injected manager, builder, handle or model shortcut — funnels through one manager method that resolves its action from the container, so an action you rebind applies everywhere.
- Every booking write runs in one transaction and the package events fire only once it commits: a refused or failed booking leaves no row and fires no event.
- The builder, the handle and the participants accessor are built for you — start from schedule() and for(), never new.

## Show your open-source love

This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.

[More ways to support, including crypto](https://roundly-consulting.com/support-us.md)

By donating, you agree to our [donation terms](https://roundly-consulting.com/donation-terms.md).

[Support our open source work (opens in a new tab)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Join us on Patreon (opens in a new tab)](https://www.patreon.com/cw/roundly)

## Want this built into your product?

We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.

[Get a quote in 48 hours](https://roundly-consulting.com/contact.md) [Browse all packages](https://roundly-consulting.com/open-source/docs/appointments-for-laravel.md)