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

# Calendar

> Connect Google Calendar or Cal.com so your AI receptionist can check availability and book appointments in real time.

Boltcall supports two calendar integrations. Connect one (or both) to enable live availability checking and automatic appointment booking.

<Tabs>
  <Tab title="Google Calendar">
    ## Google Calendar

    Google Calendar uses OAuth — you connect by signing in with your Google account. No API key is required.

    Once connected, your AI receptionist checks your calendar for open slots in real time and creates appointment events automatically when a booking is confirmed.

    ### What you get

    * **Auto-book appointments** — Boltcall creates calendar events when appointments are confirmed
    * **Two-way sync** — changes made in Google Calendar reflect in Boltcall, and vice versa
    * **No double bookings** — availability is checked live before any slot is offered to a caller

    ### How to connect

    <Steps>
      <Step title="Open the Google Calendar integration">
        Go to **Dashboard → Integrations → Google Calendar** and click the integration card.
      </Step>

      <Step title="Click Connect with Google">
        Click the **Connect with Google** button. You'll be redirected to Google's sign-in page.
      </Step>

      <Step title="Sign in and grant access">
        Sign in with the Google account that owns the calendar you want to use, then grant Boltcall permission to read and write to your calendar.
      </Step>

      <Step title="Confirm the connection">
        You'll be redirected back to your dashboard. A green "Connected" badge confirms the integration is active.
      </Step>
    </Steps>

    <Note>
      Boltcall requests calendar read and write permissions. This allows your AI receptionist to check availability and create appointment events on your behalf.
    </Note>

    ### Sync settings

    After connecting, you can configure sync behavior under **Dashboard → Integrations → Google Calendar → Sync Settings**.

    **Sync direction**

    | Option  | Behavior                                        |
    | ------- | ----------------------------------------------- |
    | One-way | Boltcall creates events in Google Calendar only |
    | Two-way | Changes sync in both directions                 |

    **Sync frequency**

    | Option       | Behavior                       |
    | ------------ | ------------------------------ |
    | Real-time    | Syncs instantly on every event |
    | Every 5 min  | Batches syncs every 5 minutes  |
    | Every 15 min | Batches syncs every 15 minutes |

    **Conflict resolution** (two-way sync only)

    When the same event is modified in both systems, you can choose which version wins: Boltcall, Google Calendar, or whichever was updated most recently.

    **Event settings**

    * **Default event duration** — 15, 30, 45, 60, 90, or 120 minutes
    * **Buffer between events** — 0, 5, 10, 15, or 30 minutes of padding after each appointment
    * **Auto-create events** — toggle whether Boltcall automatically creates a calendar event when an appointment is booked

    ### Reconnecting or disconnecting

    To reconnect (e.g. after a token expires), go to **Sync Settings** and click **Reconnect**. To remove the integration, click **Disconnect**.

    ### Sync history

    Every sync action is logged. Go to **Dashboard → Integrations → Google Calendar → Sync History** to view past syncs, their status, and any error messages.
  </Tab>

  <Tab title="Cal.com">
    ## Cal.com

    Cal.com uses an API key connection. Once connected, Boltcall registers a webhook on your Cal.com account so that confirmed bookings are sent to Boltcall in real time.

    Your AI receptionist uses Cal.com to check availability and send SMS booking links to callers during the [SMS booking](/features/sms-booking) flow.

    ### What you get

    * **Live availability** — your AI receptionist checks your Cal.com booking page before offering a time slot
    * **SMS booking** — callers receive a direct booking link via SMS to complete scheduling on their own
    * **Booking confirmation sync** — when a booking is confirmed in Cal.com, Boltcall is notified and can trigger follow-up actions

    ### How to connect

    <Steps>
      <Step title="Open your Cal.com developer settings">
        Go to **Cal.com → Settings → Developer → API Keys**.
      </Step>

      <Step title="Create a new API key">
        Click **Create API Key**. Give it a name (e.g. "Boltcall") and copy the key that's generated.
      </Step>

      <Step title="Connect in Boltcall">
        Go to **Dashboard → Integrations → Cal.com**, paste the API key into the field labeled **Cal.com API Key**, and click **Connect Cal.com**.
      </Step>

      <Step title="Verify the connection">
        A "Connected" badge will appear on the Cal.com integration card. Boltcall will automatically register a booking webhook on your Cal.com account.
      </Step>
    </Steps>

    <Note>
      Cal.com API keys are created under **Settings → Developer → API Keys**. The key is only shown once — copy it before closing the dialog.
    </Note>

    ### How Boltcall uses Cal.com

    When a caller asks to book an appointment, your AI receptionist checks your Cal.com availability in real time. If a suitable time is available, Boltcall sends the caller an SMS with a direct link to your Cal.com booking page.

    Once the caller confirms a booking on Cal.com, Boltcall receives the confirmation via webhook and can:

    * Log the appointment to your CRM
    * Trigger automated reminders
    * Fire a `appointment_booked` webhook event to any connected system

    <Tip>
      Make sure your Cal.com event types are configured with accurate availability windows. Boltcall reads these directly when checking open slots for callers.
    </Tip>

    ### Webhook registration

    Boltcall automatically registers a booking webhook on your Cal.com account during setup. You don't need to configure this manually. If you ever need to re-register it, disconnect and reconnect the Cal.com integration.
  </Tab>
</Tabs>