Connect your Outlook calendar

OtiumWork can automatically pull your Microsoft 365 / Outlook meetings into your timeline so the time you spend in meetings shows up as events without you having to log them manually.

How to connect

1. Open My Day (or any page where your events list is visible).
2. Click Connect Outlook (button appears in the integrations strip if you don't already have a connection).
3. You'll be redirected to Microsoft's sign-in page. Use the same Microsoft account that hosts your work calendar.
4. Approve the requested permissions (read your calendar, read your profile so we know which mailbox you connected).
5. Microsoft redirects you back to OtiumWork. You'll see a green "Outlook connected for your.email@company.com" banner.

What gets imported

After connecting, click Sync in the integrations strip to pull the last 7 days of meetings. After the first manual sync, OtiumWork runs a background sync nightly so future meetings appear automatically.

Each meeting becomes an event with: - Start + end time from the Outlook entry - Title from the meeting subject - Category / work-type auto-suggested (you can recategorise later) - Marked as source = outlook so you can tell auto-imported events apart

What does NOT get imported

• Cancelled meetings
• All-day events without a specific time range
• Meetings older than the sync window (default 7 days back)
• Meeting body / attendee list / attachments — we only read the time + title

Disconnect

Same integrations strip → Disconnect Outlook. This deletes the stored refresh token and stops future syncs. Previously-imported events stay in your timeline (they're just normal events at that point).

Troubleshooting

"Your admin hasn't configured Microsoft credentials yet"

Your company hasn't set up the Microsoft 365 app registration. An admin needs to go to Admin → Settings → Microsoft credentials and enter the tenant ID + client ID + client secret. After that you can re-try Connect.

"approval request sent" / scopes need admin consent

Some Microsoft tenants require an admin to pre-approve the OtiumWork app's permissions. Ask a tenant admin to: 1. Open Azure Portal → App registrations → OtiumWork 2. Go to API permissions 3. Click Grant admin consent for [your tenant]

After admin consent is granted, you can click Connect again and it'll go through.

"Microsoft did not return a refresh_token"

Means the offline_access scope wasn't granted. Disconnect, then connect again and make sure you don't uncheck any scope on the consent screen.

"Your sign-in session expired before Microsoft redirected back"

You opened the Microsoft sign-in in a different tab or browser. Click Connect again and complete the prompts in the same tab.

Events imported but in wrong time zone

OtiumWork uses your profile's time zone. Check My Day → settings → Time zone. If it's set to UTC, switch to your actual zone and re-sync.

Privacy

OtiumWork only requests two Microsoft Graph scopes: - Calendars.Read — read your calendar entries (start/end/title only) - User.Read — read your basic profile so we display which account is connected - offline_access — allows nightly background sync without you having to re-sign in every time

We never request mailbox / email contents, contact list, or write access to your calendar.

For admins setting this up the first time

See Admin Settings → Microsoft credentials for the one-time tenant config. You'll need: - Microsoft Entra ID tenant - App registration with redirect URI: https://otiumwork.com/admin/integrations/outlook/callback - Client ID + Client secret - Above three Graph permissions added + admin-consented

After that, every employee can self-serve Connect without your involvement.