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

# Create a calendar

> Set up an appointment calendar in the HoopAI Platform — choose your calendar type, configure availability, and start accepting bookings from any page or link.

export const CourseTracker = ({courseId, lessonId, videoId}) => {
  const [progress, setProgress] = useState({});
  const [expanded, setExpanded] = useState(false);
  useEffect(() => {
    setProgress(loadProgress());
    document.body.setAttribute("data-academy", "true");
    return () => document.body.removeAttribute("data-academy");
  }, []);
  const course = COURSES[courseId];
  if (!course) return null;
  const lessons = course.lessons;
  const currentIndex = lessons.findIndex(l => l.id === lessonId);
  const completedCount = lessons.filter(l => !!progress[courseId + "/" + l.id]).length;
  const percent = lessons.length > 0 ? Math.round(completedCount / lessons.length * 100) : 0;
  const isCurrentDone = !!progress[courseId + "/" + lessonId];
  const prev = currentIndex > 0 ? lessons[currentIndex - 1] : null;
  const next = currentIndex < lessons.length - 1 ? lessons[currentIndex + 1] : null;
  const totalDuration = formatTotalDuration(lessons);
  const handleToggle = () => {
    const key = courseId + "/" + lessonId;
    const updated = {
      ...progress
    };
    if (updated[key]) {
      delete updated[key];
    } else {
      updated[key] = Date.now();
    }
    setProgress(updated);
    persistProgress(updated);
  };
  const lessonPath = lesson => "/academy/" + course.dir + "/" + lesson.id;
  const videoEmbed = videoId ? <div style={{
    position: "relative",
    width: "100%",
    paddingBottom: "56.25%",
    borderRadius: "var(--ds-radius-lg)",
    overflow: "hidden",
    marginBottom: "24px",
    background: "#000"
  }}>
      <iframe src={"https://www.youtube-nocookie.com/embed/" + videoId + "?rel=0"} title="Lesson video" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen style={{
    position: "absolute",
    top: 0,
    left: 0,
    width: "100%",
    height: "100%",
    border: "none"
  }} />
    </div> : null;
  const lessonList = lessons.map(lesson => {
    const isActive = lesson.id === lessonId;
    const isDone = !!progress[courseId + "/" + lesson.id];
    const itemStyle = {
      display: "flex",
      alignItems: "center",
      gap: "8px",
      padding: "10px 16px",
      borderTop: "1px solid var(--academy-border-subtle, #f3f4f6)",
      background: isActive ? "var(--academy-active-bg, #f9fafb)" : "transparent",
      textDecoration: "none",
      cursor: isActive ? "default" : "pointer",
      color: "inherit",
      transition: "background 0.15s"
    };
    const titleStyle = {
      flex: 1,
      fontSize: "13px",
      fontWeight: isActive ? 600 : 400,
      color: isActive ? "var(--academy-text, #111827)" : "var(--academy-text-secondary, #6b7280)",
      overflow: "hidden",
      textOverflow: "ellipsis",
      whiteSpace: "nowrap",
      lineHeight: "1.4"
    };
    const durationStyle = {
      fontSize: "12px",
      color: "var(--academy-text-muted, #9ca3af)",
      whiteSpace: "nowrap"
    };
    const inner = <>
        {isDone ? <CheckCircle /> : <VideoIcon />}
        <span style={titleStyle}>{lesson.title}</span>
        <span style={durationStyle}>{lesson.duration}</span>
      </>;
    if (isActive) {
      return <div key={lesson.id} style={itemStyle}>
          {inner}
        </div>;
    }
    return <a key={lesson.id} href={lessonPath(lesson)} style={itemStyle}>
        {inner}
      </a>;
  });
  return <div className="not-prose" id="academy-course-tracker">
      {videoEmbed}
      <div className="academy-tracker" style={{
    fontFamily: "Inter, -apple-system, BlinkMacSystemFont, sans-serif",
    borderRadius: "var(--ds-radius-lg)",
    border: "1px solid var(--academy-border, #e5e7eb)",
    background: "var(--academy-bg, #ffffff)",
    overflow: "hidden",
    marginBottom: "24px"
  }}>
        {}
        <div style={{
    padding: "16px 16px 0"
  }}>
          <h3 style={{
    margin: 0,
    fontSize: "16px",
    fontWeight: 600,
    lineHeight: "1.4",
    color: "var(--academy-text, #111827)"
  }}>
            {course.title}
          </h3>
          <div style={{
    display: "flex",
    gap: "12px",
    marginTop: "8px"
  }}>
            <span style={{
    display: "flex",
    alignItems: "center",
    gap: "5px",
    fontSize: "12px",
    color: "var(--academy-text-secondary, #6b7280)",
    padding: "3px 8px 3px 6px",
    borderRadius: "var(--ds-radius-sm)",
    border: "1px solid var(--academy-border, #e5e7eb)"
  }}>
              <BookIcon /> {lessons.length} lessons
            </span>
            <span style={{
    display: "flex",
    alignItems: "center",
    gap: "5px",
    fontSize: "12px",
    color: "var(--academy-text-secondary, #6b7280)",
    padding: "3px 8px 3px 6px",
    borderRadius: "var(--ds-radius-sm)",
    border: "1px solid var(--academy-border, #e5e7eb)"
  }}>
              <ClockIcon /> Approx. {totalDuration}
            </span>
          </div>
        </div>

        {}
        <div style={{
    padding: "14px 16px 16px"
  }}>
          <div style={{
    display: "flex",
    justifyContent: "space-between",
    fontSize: "12px",
    color: "var(--academy-text-secondary, #6b7280)"
  }}>
            <span>Your progress</span>
            <span style={{
    fontWeight: 500,
    color: "var(--academy-text, #111827)"
  }}>
              {percent}%
            </span>
          </div>
          <div style={{
    height: "6px",
    borderRadius: "var(--ds-radius-full)",
    background: "var(--academy-track, #f3f4f6)",
    marginTop: "8px",
    overflow: "hidden"
  }}>
            <div style={{
    height: "100%",
    borderRadius: "var(--ds-radius-full)",
    background: "var(--academy-progress, #3b82f6)",
    transition: "width 0.5s cubic-bezier(0.4, 0, 0.2, 1)",
    width: percent + "%"
  }} />
          </div>
        </div>

        {}
        <div className="academy-lessons-desktop">{lessonList}</div>

        {}
        <div className="academy-lessons-mobile">
          <button onClick={() => setExpanded(!expanded)} aria-expanded={expanded} style={{
    display: "flex",
    alignItems: "center",
    justifyContent: "space-between",
    padding: "12px 16px",
    cursor: "pointer",
    borderTop: "1px solid var(--academy-border-subtle, #f3f4f6)",
    background: "transparent",
    border: "none",
    borderTopStyle: "solid",
    borderTopWidth: "1px",
    borderTopColor: "var(--academy-border-subtle, #f3f4f6)",
    width: "100%",
    textAlign: "left",
    color: "var(--academy-text-secondary, #6b7280)",
    fontSize: "13px",
    fontWeight: 500,
    fontFamily: "inherit"
  }}>
            <span>
              {expanded ? "Hide lessons" : "Show all " + lessons.length + " lessons"}
            </span>
            <ChevronDown open={expanded} />
          </button>
          {expanded && lessonList}
        </div>

        {}
        <div style={{
    display: "flex",
    alignItems: "center",
    justifyContent: "space-between",
    borderTop: "1px solid var(--academy-border, #e5e7eb)",
    padding: "10px 16px"
  }}>
          {prev ? <a href={lessonPath(prev)} style={{
    fontSize: "13px",
    color: "var(--academy-text-secondary, #6b7280)",
    textDecoration: "none",
    display: "flex",
    alignItems: "center",
    gap: "4px"
  }}>
              ‹ Previous
            </a> : <div />}
          <button onClick={handleToggle} style={{
    fontSize: "13px",
    fontWeight: 500,
    cursor: "pointer",
    padding: "6px 14px",
    borderRadius: "var(--ds-radius-md)",
    border: isCurrentDone ? "1px solid var(--academy-border, #e5e7eb)" : "none",
    background: isCurrentDone ? "var(--academy-bg, #ffffff)" : "var(--academy-btn-bg, #111827)",
    color: isCurrentDone ? "var(--academy-complete, #10b981)" : "var(--academy-btn-text, #ffffff)",
    display: "flex",
    alignItems: "center",
    gap: "6px",
    transition: "all 0.2s",
    lineHeight: "1.4",
    fontFamily: "inherit"
  }}>
            {isCurrentDone ? <>
                <CheckCircle /> Completed
              </> : "Mark as completed"}
          </button>
          {next ? <a href={lessonPath(next)} style={{
    fontSize: "13px",
    color: "var(--academy-text-secondary, #6b7280)",
    textDecoration: "none",
    display: "flex",
    alignItems: "center",
    gap: "4px"
  }}>
              Next ›
            </a> : <div />}
        </div>
      </div>
    </div>;
};

<CourseTracker courseId="calendars" lessonId="create-calendar" />

The HoopAI Platform's calendar feature offers tailored solutions to streamline appointment scheduling. Whether you need one-on-one bookings, round-robin distribution across a team, or group class registrations, the calendar system handles it all — and every confirmed appointment triggers automatic confirmations and reminders.

<Frame caption="The Create Calendar lesson in the HoopAI Academy Calendars section">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/gyU98wGhFXcTdqFf/images/academy-calendars-create.png?fit=max&auto=format&n=gyU98wGhFXcTdqFf&q=85&s=5be7ef7b0f6b19bf1fea5441430fb3ed" alt="Create a calendar article" width="1536" height="826" data-path="images/academy-calendars-create.png" />
</Frame>

## Why this matters

Manual appointment scheduling — back-and-forth emails, forgotten follow-ups, missed bookings — wastes hours every week and loses leads who give up waiting. A self-booking calendar lets prospects choose a time 24/7, automatically confirms the appointment, and sends reminders — all without any manual effort from you.

## Calendar types

Before creating your calendar, choose the type that fits your use case:

<AccordionGroup>
  <Accordion title="Round Robin">
    Distributes incoming bookings evenly across multiple team members based on availability. Best for sales teams where any qualified rep can handle a discovery call.
  </Accordion>

  <Accordion title="Collective">
    All listed team members must be available for the appointment to show as open. Best for meetings that require multiple people to attend simultaneously.
  </Accordion>

  <Accordion title="Service (one-on-one)">
    A standard individual booking calendar. One contact books with one specific person. Best for consultations, coaching sessions, and personal appointments.
  </Accordion>

  <Accordion title="Class Booking">
    A group session calendar where multiple contacts can book the same time slot up to a set maximum. Best for workshops, group coaching, or fitness classes.
  </Accordion>
</AccordionGroup>

## How to create a calendar

<Steps>
  <Step title="Navigate to Calendars">
    Go to **Calendars** > **Calendar Settings** in the left sidebar. Click **Create Calendar**.

    <Frame caption="The Calendar Settings page in the HoopAI Platform">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/gyU98wGhFXcTdqFf/images/academy-calendars-create.png?fit=max&auto=format&n=gyU98wGhFXcTdqFf&q=85&s=5be7ef7b0f6b19bf1fea5441430fb3ed" alt="Calendar settings navigation" width="1536" height="826" data-path="images/academy-calendars-create.png" />
    </Frame>
  </Step>

  <Step title="Choose your calendar type">
    Select the calendar type that matches your scheduling needs — Round Robin, Collective, Service, or Class Booking. Give your calendar a clear name that will make sense to the contacts booking it.
  </Step>

  <Step title="Set your availability">
    Configure when appointments can be booked:

    * **Working hours:** Set the days and time windows when you are available
    * **Slot duration:** How long each appointment is — 15 minutes, 30 minutes, 1 hour, etc.
    * **Buffer time:** Gap between appointments — prevents back-to-back bookings
    * **Minimum notice:** How far in advance a contact must book — prevents last-minute appointments

    <Frame caption="Configuring availability, slot duration, and buffer time in the calendar settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/gyU98wGhFXcTdqFf/images/academy-calendars-create.png?fit=max&auto=format&n=gyU98wGhFXcTdqFf&q=85&s=5be7ef7b0f6b19bf1fea5441430fb3ed" alt="Calendar availability configuration" width="1536" height="826" data-path="images/academy-calendars-create.png" />
    </Frame>
  </Step>

  <Step title="Customize the booking page">
    Configure what the contact sees when they open your booking link:

    * **Calendar title and description**
    * **Questions to ask before booking** — collect name, phone, company, or custom fields
    * **Confirmation message** — what is displayed after a successful booking
    * **Logo and brand colors** for a professional, branded experience
  </Step>

  <Step title="Connect your calendar integrations">
    Under the calendar's integration settings, connect your **Google Calendar** or **Outlook Calendar** to check real-time availability and prevent double-bookings. See the [Sync Integrations](/academy/calendars/sync-integrations) guide for setup.

    <Tip>
      Always connect your Google or Outlook calendar before going live. Without the integration, the calendar cannot check your real availability — contacts may book times when you are already occupied.
    </Tip>
  </Step>

  <Step title="Configure confirmation and reminder automation">
    Set up automatic messages that fire when appointments are booked:

    * **Confirmation email or SMS** — sent immediately after booking
    * **Reminder messages** — sent 24 hours and 1 hour before the appointment
    * **Follow-up messages** — sent after the appointment to collect reviews or next steps

    See the [Configure Your Appointment Automation](/academy/calendars/configure-your-appointment-automation) guide for detailed workflow setup.
  </Step>

  <Step title="Get your booking link">
    Once saved, the calendar generates a unique booking URL. Copy it and share it anywhere:

    * Add it to your website or funnel pages
    * Include it in email signatures and SMS messages
    * Add it to your social media bio
    * Embed the booking widget directly on a page using the embed code

    <Frame caption="The booking link and embed code ready to share from the calendar settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/gyU98wGhFXcTdqFf/images/academy-onboarding-buy-phone-number.png?fit=max&auto=format&n=gyU98wGhFXcTdqFf&q=85&s=ef2b18bc4019dd33e411f28c4cf5e1c5" alt="Calendar booking link and embed code" width="1536" height="826" data-path="images/academy-onboarding-buy-phone-number.png" />
    </Frame>
  </Step>
</Steps>

## Key benefits

<AccordionGroup>
  <Accordion title="Efficient scheduling">
    Optimize appointment booking for both you and your clients without manual coordination.
  </Accordion>

  <Accordion title="24/7 availability">
    Contacts can book any time — even outside business hours — without waiting for a response.
  </Accordion>

  <Accordion title="Automated confirmations">
    Every booking triggers immediate confirmation messages and reminders automatically.
  </Accordion>

  <Accordion title="Customizable branding">
    Brand the booking page with your logo and colors for a professional client experience.
  </Accordion>

  <Accordion title="Maximized team resources">
    Round Robin and Collective options distribute bookings fairly and prevent scheduling conflicts.
  </Accordion>
</AccordionGroup>
