> ## 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.

# Set up booking pages, embeds, and one-time links

> Share booking links, embed your calendar on any website, create one-time links, and enable Google organic booking in HoopAI.

Booking pages are how contacts access your calendars — whether through a direct link, an embedded widget on your website, a Google Business Profile listing, or a single-use link for a specific contact. This guide covers all methods for sharing and embedding your calendars.

## Sharing your booking link

Every calendar in Hoop has a unique booking URL. Share this link anywhere — email signatures, SMS messages, social profiles, or your website.

To copy your booking URL:

1. Go to **Calendar Settings**
2. Click the **share icon** (arrow pointing right) on the calendar card
3. Copy the **Direct Link** from the Share modal

<Frame caption="The Share modal showing the direct booking link for a calendar">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-one-time-link1.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=78ed7c41ad3b34cf27161fe255e89076" alt="Calendar share modal with direct link" width="1583" height="619" data-path="images/calendars-one-time-link1.png" />
</Frame>

***

## Embedding your calendar on a website

Embed a booking widget directly in your website so visitors can book without leaving your page.

<Steps>
  <Step title="Open the Share modal">
    In Calendar Settings, click the share icon on the calendar you want to embed.

    <Frame caption="Click the share icon on the calendar card to open the Share modal">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-embed1.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=67589d77bd98a3863cde68f480024ac9" alt="Calendar settings with share icon highlighted" width="1575" height="615" data-path="images/calendars-embed1.png" />
    </Frame>
  </Step>

  <Step title="Copy the embed code">
    In the Share modal, switch to the **Embed** tab. Copy the iframe code snippet.

    <Frame caption="The Embed tab in the Share modal showing the iframe code">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-embed2.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=785851941b33f0b31a2689130422d94b" alt="Embed tab with iframe code" width="865" height="649" data-path="images/calendars-embed2.png" />
    </Frame>
  </Step>

  <Step title="Paste into your website">
    Add the embed code to your website's HTML where you want the calendar widget to appear.

    <Frame caption="Paste the iframe embed code into your website's HTML">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/IfenqDY0m-v5LGvA/images/calendars-embed3.png?fit=max&auto=format&n=IfenqDY0m-v5LGvA&q=85&s=fbff26b8b597ed7d5197ca7d86ddc887" alt="Iframe code pasted into website editor" width="860" height="544" data-path="images/calendars-embed3.png" />
    </Frame>
  </Step>
</Steps>

### Embedding in a Hoop funnel or website

To add your calendar to a Hoop-built funnel or website:

<Steps>
  <Step title="Open your funnel or website in the builder">
    Navigate to **Sites > Funnels** or **Sites > Websites** and open the page editor.
  </Step>

  <Step title="Add a custom code element">
    Drag a **Custom Code** element onto the page where you want the calendar to appear.
  </Step>

  <Step title="Paste the embed code">
    Open the element settings and paste the calendar iframe code.
  </Step>

  <Step title="Publish">
    Click **Publish** to make the embedded calendar live on your page.
  </Step>
</Steps>

<Tip>
  For a seamless experience, use the booking widget's color customization settings to match your website's brand colors before embedding.
</Tip>

***

## One-time booking links

One-time booking links expire after a single use — ideal for sending to a specific contact without making the link publicly reusable.

**Common use cases:**

* Sending a booking link to a VIP client without opening up your calendar to others
* Creating discovery call links that cannot be forwarded or reused
* Secure scheduling for sensitive appointments

<Steps>
  <Step title="Open the calendar settings">
    Navigate to the calendar for which you want to create a one-time link.

    <Frame caption="Navigate to the calendar and access the one-time booking link settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-one-time-link1.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=78ed7c41ad3b34cf27161fe255e89076" alt="Calendar settings showing one-time booking link option" width="1583" height="619" data-path="images/calendars-one-time-link1.png" />
    </Frame>
  </Step>

  <Step title="Find One-Time Booking Links">
    In the calendar settings, scroll to or click **One-Time Booking Links**.

    <Frame caption="The One-Time Booking Links section in calendar settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-one-time-link2.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=e74f72edf1c15ed972e54384672d8639" alt="One-Time Booking Links section" width="1265" height="385" data-path="images/calendars-one-time-link2.png" />
    </Frame>
  </Step>

  <Step title="Create and copy the link">
    Click **+ Create Link**. Copy the generated URL and send it directly to the contact.

    <Frame caption="Copy the generated one-time booking link to share with a specific contact">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-one-time-link3.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=4f73a64c82393d9548c209bf9deddc3a" alt="Generated one-time booking link" width="826" height="454" data-path="images/calendars-one-time-link3.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  One-time booking links expire immediately after use or can be set to expire after a set period. They cannot be recovered once expired.
</Warning>

***

## Google organic booking

Google Organic Booking lets contacts book directly from your Google Business Profile — right from Google Search or Google Maps results.

<Steps>
  <Step title="Open the calendar's settings">
    Navigate to **Calendar Settings** and click on the calendar you want to list on Google.

    <Frame caption="Open Calendar Settings and select the calendar for Google organic booking">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-organic-booking-settings.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=194290a8c5c54fbf2bb308b87a398578" alt="Calendar Settings with Google organic booking option" width="1141" height="348" data-path="images/calendars-organic-booking-settings.png" />
    </Frame>
  </Step>

  <Step title="Enable Google Organic Booking">
    Find the **Google Organic Booking** section and toggle it on.

    <Frame caption="The Google Organic Booking toggle in Calendar Settings">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-organic-booking-gob.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=cd21b349435efaa5dc34ee9062607d52" alt="Google Organic Booking toggle" width="695" height="306" data-path="images/calendars-organic-booking-gob.png" />
    </Frame>
  </Step>

  <Step title="Enable the booking option">
    Toggle on the booking listing so it becomes active on your Google Business Profile.

    <Frame caption="Enable the booking listing to make it visible on your Google Business Profile">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-organic-booking-enable.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=ad373fd8ee49d47774cace7f83703421" alt="Enable Google organic booking listing" width="747" height="214" data-path="images/calendars-organic-booking-enable.png" />
    </Frame>
  </Step>

  <Step title="Upload required assets">
    Upload photos and other assets required by Google for Business Profile listings.

    <Frame caption="Upload required photos and assets for the Google Business Profile listing">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/kH-7_ePI0C0Dun2-/images/calendars-organic-booking-upload.png?fit=max&auto=format&n=kH-7_ePI0C0Dun2-&q=85&s=a2b57eab4be5f572f15a05c2d9d55426" alt="Upload assets for Google organic booking" width="739" height="294" data-path="images/calendars-organic-booking-upload.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Your Google Business Profile must be verified and connected in your account integrations before enabling Google Organic Booking.
</Note>

### Disabling Google organic booking

To remove your calendar from Google Business Profile:

1. Go to **Calendar Settings** for the calendar
2. Find the **Google Organic Booking** section
3. Toggle the setting off
4. Save the changes

The listing is removed from Google Business Profile within 24–48 hours.

***

## Calendar groups as booking pages

Calendar groups create a combined booking page that displays multiple calendars together. This is useful for teams, multi-service offerings, and multi-location businesses.

To set up a calendar group:

1. Go to **Calendar Settings > Groups**
2. Click **+ New Group** and give it a name and URL slug
3. Add calendars to the group via the calendar settings or the three-dot menu on each calendar card
4. Share the group booking link — contacts can browse all calendars in the group and choose their preferred slot

<Tip>
  Use calendar groups to create a team booking page where contacts can see all available team members and pick their preferred one.
</Tip>

***

## Customizing your booking page

Each calendar's booking widget can be customized to match your brand:

* **Color scheme** — button color, date highlight color, time slot color, and action colors
* **Background color** — the backdrop behind the booking form
* **Button text** — replace "Book Now" with custom copy
* **Calendar logo** — displayed at the top of the booking widget
* **Cover image** — appears in group/Neo widget views
* **Widget style** — choose between Classic and Neo layouts
* **Show/hide details** — toggle calendar name, description, duration, and timezone display

Access customization options in **Calendar Settings > Advanced Settings > Customizations**.

***

## Consent checkbox for compliance

Add a required consent checkbox to your booking form for SMS marketing and data privacy compliance. When enabled, contacts must check the box before completing their booking.

To enable the consent checkbox:

1. Go to **Calendar Settings > Advanced Settings > Forms & Payment**
2. Toggle on **Consent Checkbox**
3. Customize the consent text (e.g., "I agree to receive SMS messages from \[Business Name]")
4. Save the calendar

<Note>
  The consent checkbox is recommended for businesses that send SMS follow-ups or marketing messages to contacts who book appointments. It helps maintain compliance with TCPA and other messaging regulations.
</Note>

***

## Add guests feature in bookings

The Add Guests feature lets contacts include additional attendees when booking an appointment. This is useful for group meetings, family appointments, or any scenario where multiple people need to attend.

When guests are added:

* Each guest receives their own confirmation and reminder notifications
* Guest names and email addresses are stored on the appointment record
* For class booking calendars with per-attendee pricing, the total is calculated based on the number of guests

To enable:

1. Go to **Calendar Settings > Forms & Payment**
2. Toggle on **Allow Guests**
3. Optionally enable **Require Guests** to make guest information mandatory
4. Save

***

## FAQs

<AccordionGroup>
  <Accordion title="Can I embed multiple calendars on the same page?">
    Yes. Generate an embed code for each calendar individually and paste the iframe snippets side by side or stacked in your page HTML. Alternatively, create a calendar group and embed the group booking page as a single widget that shows all calendars together.
  </Accordion>

  <Accordion title="Does the embedded calendar update automatically when I change availability?">
    Yes. The embed is a live iframe that always reflects the current availability settings of your calendar. You do not need to update the embed code after changing hours, buffer times, or other settings.
  </Accordion>

  <Accordion title="Can I create one-time links in bulk?">
    No. One-time links must be created individually — each link is tied to a single use. For sending personalized booking links to many contacts, use a workflow action that sends the calendar booking link via SMS or email, which remains reusable but is delivered to one contact at a time.
  </Accordion>

  <Accordion title="What happens to a one-time link that has not been used?">
    Unused one-time links remain valid indefinitely until they are either used or manually deleted from the One-Time Booking Links section in Calendar Settings.
  </Accordion>

  <Accordion title="How long does it take for Google Organic Booking to appear on my Business Profile?">
    After enabling the feature and uploading the required assets, it typically takes 24–72 hours for the booking option to appear on your Google Business Profile. Google reviews and activates the listing on their side.
  </Accordion>

  <Accordion title="Can I use a calendar group as an embed?">
    Yes. Calendar groups have their own shareable and embeddable booking pages. In Calendar Settings, find the group, use its three-dot action menu, and select **Copy embed code** to get the iframe snippet for the group's combined booking page.
  </Accordion>
</AccordionGroup>
