add-office365

📋 Shared Instructions: shared-instructions.md — Cross-cutting concerns.

Add Office 365 Outlook (Wrapper)

This skill is a thin wrapper. Use /add-data-source as the single implementation path.

Delegation contract

Invoke /add-data-source with:

• api-id: shared_office365
• mode: action

---

Office 365 Connector: Method Selection Guide

After the connector is added, you'll have access to Office365OutlookService with 20+ methods. Use this guide to select the right method for your use case.

Calendar Operations

For Fetching Events in a Date Range: GetEventsCalendarViewV2

Best for: Meeting lists, calendar views, event queries between two dates (e.g., "past 7 days", "next 30 days").

Key Parameters:

• calendarId (string) — Always discover using CalendarGetTables() first
• startDateTimeOffset (ISO 8601 string) — Use .toISOString()
• endDateTimeOffset (ISO 8601 string) — Use .toISOString()
• top, skip (optional) — For pagination (200-1000 range typical)

Pattern:

import { Office365OutlookService } from '../../generated/services/Office365OutlookService'

// Step 1: Discover calendar ID (validate and prefer primary calendar)
const calendarsResult = await Office365OutlookService.CalendarGetTables()
if (!calendarsResult.success) {
  throw new Error(calendarsResult.error?.message ?? 'Failed to list calendars')
}

const calendars = calendarsResult.data?.value ?? []
if (calendars.length === 0) {
  throw new Error('No calendars found in Office 365 connection')
}

// Prefer primary 'calendar' (by DisplayName), fall back to first
const defaultCalendar =
  calendars.find((c: any) => (c.DisplayName ?? '').toLowerCase() === 'calendar') 
  ?? calendars[0]
const calendarId = defaultCalendar?.Name ?? calendars[0]?.Name

if (!calendarId) {
  throw new Error('Could not determine calendar ID from response')
}

// Step 2: Query events with pagination
const eventsResult = await Office365OutlookService.GetEventsCalendarViewV2(
  calendarId,
  startDate.toISOString(),
  endDate.toISOString(),
  undefined,        // filter (optional)
  undefined,        // select (optional)
  200,              // top - results per page
  0                 // skip - pagination offset
)

if (!eventsResult.success) {
  throw new Error(eventsResult.error?.message ?? 'Failed to fetch events')
}

const meetings = eventsResult.data?.value ?? []