{ "title": "Calendar Sync Setup", "images": [], "text": "

Calendar Sync lets EnRep push Surveyor Diary appointments, holidays, and meetings into each connected surveyor or administrator Microsoft Outlook or Google Calendar. EnRep stays as the master diary, so entries should still be created, moved, and removed in EnRep.

Set this up once: this card is for the organisation-level connection details. Surveyors and administrators connect their own calendar afterwards from their profile.

Redirect URL

Copy the Redirect URL exactly as shown in the Calendar Sync card.

Add that exact value as a Web redirect URI in Microsoft Entra and as an authorised redirect URI in Google Cloud.

Microsoft Outlook setup

  1. Open Microsoft Entra admin centre.
  2. Go to Applications, then App registrations, and create a new registration for EnRep Calendar Sync.
  3. Set the supported account type required by the organisation. For most work accounts, use accounts in this organisational directory only.
  4. Add the Redirect URL from this card as a Web redirect URI.
  5. Go to Certificates & secrets and create a new client secret. Copy the secret value immediately.
  6. Go to API permissions, choose Microsoft Graph, then Delegated permissions.
  7. Add Calendars.ReadWrite, MailboxSettings.ReadWrite, offline_access, and User.Read.
  8. If the organisation blocks user consent, an Entra administrator must grant admin consent for these delegated permissions.
  9. Copy the Directory tenant id, Application client id, and client secret into this card.
  10. Switch on Microsoft calendar sync and save.
Calendar colours: MailboxSettings.ReadWrite lets EnRep create three Outlook categories for appointments, holidays, and meetings. After adding this permission, reconnect each Microsoft calendar once so the new permission is granted.
Security note: use delegated permissions for this feature. Do not use Microsoft application permission Calendars.ReadWrite unless a separate organisation-wide design has been approved.

Google Calendar setup

  1. Open Google Cloud Console.
  2. Create or select a project for EnRep Calendar Sync.
  3. Enable the Google Calendar API.
  4. Configure the OAuth consent screen for the organisation.
  5. Create an OAuth client id for a Web application.
  6. Add the Redirect URL from this card to the authorised redirect URIs.
  7. Copy the OAuth client id and client secret into this card.
  8. Switch on Google calendar sync and save.
Google verification: Google Calendar access uses sensitive OAuth permissions. While the Google app is in testing, each surveyor Google account must be added as a test user. If the app is published but not verified, Google may show an unverified app warning. For normal client rollout, submit the Google OAuth app for verification with a privacy policy, verified domain, scope justification, and a short demo of the EnRep calendar connection flow.

EnRep requests access to create, update, and remove events in each connected calendar. Surveyors and administrators connect their own account from their profile.

After setup

Open each surveyor or administrator profile, choose Microsoft or Google, then use Connect calendar. Once connected, new and changed diary entries are processed automatically.

Important: do not ask users to edit EnRep diary entries in Outlook or Google. External calendars are a one-way view of the EnRep diary.
" }