> ## Documentation Index > Fetch the complete documentation index at: https://docs.vozagent.ai/llms.txt > Use this file to discover all available pages before exploring further. # Calendar Integration Issues > Troubleshooting calendar sync problems, OAuth authorization errors, and appointments not appearing. If your calendar integration isn't working as expected -- appointments aren't showing up, your assistant can't check availability, or you're seeing authorization errors -- this guide covers the most common issues and how to fix them. *** ## Calendar Not Connected or Shows Disconnected **Symptoms:** Your assistant can't book appointments, or the Integrations page shows your calendar as disconnected even though you previously connected it. **Solutions:** 1. **Check the integration status.** Go to **Integrations** in the sidebar and find your calendar provider (Google Calendar, Calendly, or Cal.com). Look for a green "Connected" badge. If it shows disconnected, you'll need to reconnect. 2. **Reconnect your calendar.** Click on the calendar integration card and follow the connection steps again. For Google Calendar and Calendly, this means going through the OAuth sign-in flow. For Cal.com, you'll need to re-enter your API key. 3. **Check if the token expired.** Calendar tokens can expire over time, especially for Google Calendar and Calendly. When this happens, the integration silently disconnects. Reconnecting generates a fresh token. > **Tip:** After reconnecting, test the integration by placing a call to your VozAgent number and asking about scheduling. This confirms the assistant can read your calendar in real time. *** ## Google Calendar Issues ### "Failed to initiate Google Calendar connection" This error appears when the OAuth handshake with Google fails. **Solutions:** 1. **Try again in a few seconds.** This is often a temporary network issue. 2. **Refresh the page** and attempt the connection again. 3. **Make sure pop-ups are allowed.** Some browsers block the redirect to Google's sign-in page. Allow pop-ups for the VozAgent domain. 4. **Clear your browser cache.** Stale cached data can interfere with the OAuth flow. Try a hard refresh (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows). ### Google Asks to Re-Authorize Permissions If Google prompts you to grant permissions again after you previously connected, this is normal. It happens when: * You disconnected and are reconnecting * Google revoked the token due to inactivity or a security policy change * You changed your Google account password Simply review the permissions and click **Allow** to reconnect. ### Appointments Not Appearing on Google Calendar If your assistant books an appointment during a call but it doesn't appear on your Google Calendar: 1. **Verify the connection is still active.** Go to **Integrations > Google Calendar** and check for the green "Connected" badge. 2. **Check the correct calendar.** If you have multiple Google Calendars (personal, work, shared), the appointment may be on a different calendar than the one you're viewing. 3. **Wait a moment.** There can be a short delay (up to 30 seconds) between when the appointment is booked and when it appears on Google Calendar. 4. **Refresh Google Calendar.** In the Google Calendar web app, try refreshing the page or pressing "R" to reload events. *** ## Calendly Issues ### No Event Types Showing After Connection If you connected Calendly but VozAgent doesn't show any event types: 1. **Check your Calendly account.** Make sure you have at least one active event type configured. Inactive or archived event types won't appear in VozAgent. 2. **Disconnect and reconnect.** Go to **Integrations > Calendly**, disconnect, then reconnect. This forces VozAgent to re-import your event types. ### Calendly Sync Delays Calendly appointments may take a short time to sync back to VozAgent. 1. **Wait 1-2 minutes.** Calendly sends booking notifications through webhooks, which may have a slight delay. 2. **Check the VozAgent Calendar page.** Go to **Calendar** in the sidebar and look for the appointment. It should appear with a "calendly" provider badge. 3. **Verify the booking was created.** Log in to your Calendly dashboard and confirm the appointment exists there. ### OAuth Callback Error If you see an error after being redirected back from Calendly: 1. **Try the connection process again.** Close the error and start a new connection from the Integrations page. 2. **Make sure you're not blocking redirects.** Check your browser settings for pop-up or redirect blockers. 3. **Try a different browser.** If the issue persists in one browser, try Chrome, Firefox, or Safari. *** ## Cal.com Issues ### "Invalid API key" or "Failed to validate API key" This means VozAgent couldn't authenticate with Cal.com using the key you provided. **Solutions:** 1. **Check for extra spaces.** When copying the API key, make sure no spaces were accidentally added before or after the key. 2. **Verify the key is still valid.** Log in to Cal.com and go to **Settings > Developer > API Keys**. Make sure the key hasn't been revoked or expired. 3. **Generate a new key.** If the existing key doesn't work, create a new API key in Cal.com and try connecting again. ### "Failed to connect Cal.com" This can happen when: * Your Cal.com account doesn't have any event types set up * The API key has been revoked * Cal.com is experiencing an outage **Solutions:** 1. **Check your Cal.com event types.** Make sure you have at least one active, published event type. 2. **Generate a fresh API key.** Go to Cal.com's **Settings > Developer > API Keys**, create a new key, and use it in VozAgent. 3. **Check Cal.com's status.** Visit Cal.com's status page to see if there are any ongoing service issues. ### No Event Types Appearing After Key Validation If the test passes but no event types show in the dropdown: 1. **Verify your event types are published.** Go to your Cal.com dashboard and make sure your event types are published and not in draft mode. 2. **Check that event types are active.** Disabled event types won't appear in VozAgent. *** ## Appointments Not Showing on the VozAgent Calendar **Symptoms:** Your assistant confirms it booked an appointment during a call, but the appointment doesn't appear on the VozAgent Calendar page. **Solutions:** 1. **Check the date range.** The Calendar page shows appointments for the currently displayed date range. Use the navigation arrows or click **Today** to make sure you're viewing the correct period. 2. **Switch to the correct view.** If you're in Month view, the appointment may be a small dot on the day. Switch to **Week** or **Day** view for a more detailed look. 3. **Verify the calendar connection.** If the integration was disconnected between when the call happened and when you're checking, the appointment may not have synced. 4. **Refresh the page.** Calendar data refreshes automatically, but a manual page refresh can help if data appears stale. 5. **Check the appointment in your calendar provider.** Log in to Google Calendar, Calendly, or Cal.com directly and verify the appointment exists there. If it does but doesn't appear in VozAgent, there may be a sync delay. *** ## General Tips * **Reconnect periodically.** If you notice calendar issues after a long period without changes, try disconnecting and reconnecting your calendar. This refreshes the authentication token. * **Only one calendar provider at a time.** VozAgent connects to one calendar provider per organization. If you switch from Google Calendar to Calendly (or vice versa), the previous connection is replaced. * **Check your availability settings.** Even if the calendar is connected, your assistant uses the availability hours you configured during setup. Make sure those hours match your actual schedule. See [Booking Settings and Availability](/help/calendar-and-booking/booking-settings-and-availability). *** ## Next Steps * [Connecting Google Calendar](/help/calendar-and-booking/connecting-google-calendar) -- Full setup guide for Google Calendar * [Connecting Calendly](/help/calendar-and-booking/connecting-calendly) -- Full setup guide for Calendly * [Connecting Cal.com](/help/calendar-and-booking/connecting-calcom) -- Full setup guide for Cal.com * [Calendar & Booking Overview](/help/calendar-and-booking/calendar-overview) -- How the calendar system works * [Getting Support](/help/troubleshooting/getting-support) -- Contact VozAgent support for additional help