Integration guide
Connect MIEA with Google Calendar
Google Calendar is connected at the organization level first. After that, each practitioner is configured with a booking calendar and one or more availability calendars. Once the calendar setup is complete, finish the practitioner schedule by defining working hours, breaks, unavailable dates, days to check, and appointment duration.
About 10 minutes · Admin access required
Before you start
- Make sure the organization has at least one active practitioner.
- Have access to Admin and allow popup windows in your browser for the Google OAuth flow.
- Use a Google account that has access to the required calendars. The booking calendar must allow event creation with writer or owner access.
Step 1
Add a practitioner if needed
Google Calendar can only be connected for an organization that already has at least one active practitioner.
- 1 Open Admin.
- 2 Go to Practitioners.
- 3 Click Add practitioner.
- 4 Fill in the practitioner profile and save it.
Note: If the practitioner already exists, you can skip this step.
Step 2
Start the Google Calendar connection
This starts the Google Calendar connection flow for the organization.
- 1 Open Admin.
- 2 Go to Workspace Settings.
- 3 Expand the Integrations section.
- 4 Find Google Calendar.
- 5 Click Connect.
Step 3
Connect the Google account
After clicking Connect, a Google authorization popup should open so you can authorize calendar access for the workspace.
- 1 Sign in with the Google account that should be used for calendar access.
- 2 Select the correct account if Google shows multiple accounts.
- 3 Review the requested permissions.
- 4 Confirm access and finish the OAuth flow.
- 5 Close the popup only after the authorization flow is complete.
Note: A successful result means the Google Calendar integration becomes connected, the connected account email may appear next to the integration, and the system prompts you to continue with practitioner calendar setup.
Step 4
Open practitioner settings
The Google Calendar Settings section is located on the practitioner schedule screen.
- 1 Go to Admin.
- 2 Open Practitioners.
- 3 Find the required practitioner.
- 4 Open the actions menu in that practitioner's row.
- 5 Click Edit schedule.
Step 5
Configure Google Calendar for the practitioner
In the Google Calendar Settings section, configure both required fields before saving.
- 1 Choose the Booking calendar where MIEA should create new bookings.
- 2 Select one or more Slots availability calendars that MIEA should check for practitioner availability.
- 3 Include the booking calendar and any other calendars that can block time slots.
- 4 If multiple calendars are selected, MIEA checks all of them and treats busy slots in any of them as unavailable.
- 5 Before saving, confirm that a booking calendar is selected and that at least one availability calendar is selected.
- 6 Click Save Google Calendar Settings.
Note: The booking calendar list shows only calendars where the connected Google account can create events. If a required calendar is missing, that account does not have enough access. The save button stays disabled until both required values are set.
Step 6
Configure the practitioner schedule
On the same Edit schedule screen, complete the General Schedule Settings section.
- 1 Set Days to check to control how many days ahead the system should search for available time slots.
- 2 Set Appointment duration (min) for the length of a single appointment.
- 3 Configure Working hours and breaks for weekly availability.
- 4 Add Unavailable dates and times for vacation, sick leave, holidays, or any other blocked periods.
- 5 Click Save General Settings after making changes.
Disconnect Google Calendar for the organization
Use the workspace integration controls if you need to fully disconnect Google Calendar.
- 1 Open Admin → Workspace Settings → Integrations.
- 2 In the Google Calendar row, click Disconnect.
- 3 Confirm the action.
Note: Disconnecting removes the connected Google account, practitioners configured through that account lose their Google Calendar setup, and linked MIEA data is permanently deleted.
Troubleshoot common issues
If setup does not work as expected, check these common causes first.
- 1 The Connect button is disabled. Make sure the organization has at least one active practitioner, is not additionally using any CMS, and does not already have another enabled integration blocking Google Calendar connection.
- 2 The Google popup did not open. Allow popup windows in the browser and try again.
- 3 The correct calendar is missing from Booking calendar. Share that calendar with the connected Google account using writer or owner access, then try again.
- 4 The calendars list is empty. Confirm that the Google account is connected, access was not revoked in Google, and the connected account has access to at least one calendar.
After the workspace connection and practitioner settings are saved, MIEA can use the selected calendars to check availability and create new bookings in the chosen booking calendar.