Skip to main content

Outlook Calendar Integration

Connect and manage Outlook calendars and events through ConstellationAPI.

Overview​

Outlook Calendar integration uses Apideck's Calendar Unified API, providing a consistent interface to Outlook's calendar and scheduling features.

Prerequisites​

  • Outlook/Microsoft 365 account with appropriate permissions
  • Apideck account with Outlook Calendar integration enabled
  • Tenant created in ConstellationAPI

Authorization​

Step 1: Create Vault Session​

curl -X POST http://localhost:3007/auth/vault-session \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "integration": "outlook-calendar"
  }'

Step 2: Authorize​

  1. Open the sessionUri from the response
  2. Complete OAuth flow in Apideck Vault
  3. Grant necessary permissions

Common Operations​

List Calendars​

curl http://localhost:3007/calendar/calendars \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant"

Create Event​

curl -X POST http://localhost:3007/calendar/calendars/cal-123/events \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "title": "Team Meeting",
    "description": "Weekly sync meeting",
    "startDateTime": "2024-01-15T10:00:00Z",
    "endDateTime": "2024-01-15T11:00:00Z",
    "timezone": "America/New_York",
    "location": "Conference Room A"
  }'

Check Free/Busy​

curl -X POST http://localhost:3007/calendar/free-busy \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "startDateTime": "2024-01-15T00:00:00Z",
    "endDateTime": "2024-01-15T23:59:59Z",
    "attendees": ["john@example.com", "jane@example.com"]
  }'

Best Practices​

  1. Timezone Handling: Always specify timezones for events
  2. Recurring Events: Use recurrence patterns for regular meetings
  3. Attendee Management: Add attendees with proper email addresses
  4. Reminders: Set appropriate reminder times for events