Skip to content

Microsoft Teams Connector

Connect Microsoft Teams. OAuth uses integration: "microsoft-teams".

Base URL

BASE_URL = "https://api.fermi.dev/public/v1"

Authentication

Authorization: Bearer <service-actor-token>

Required Scopes: connectors:read, connectors:write, connectors:sync

Connect

POST /connect/integrations/connect-session

{
  "integration": "microsoft-teams"
}

Response: { "sessionToken": "..." }

List connections

GET /connect/integrations/connections?providerConfigKey=microsoft-teams

Channels and chats

GET /connect/integrations/teams/channels

GET /connect/integrations/teams/chats

Pass the connection query parameters your client already uses after Connect completes.

Sync

POST /sync/enqueue

{
  "connectionId": "CONNECTION_ID",
  "providerKey": "microsoft-teams"
}

Optional body fields on enqueue: selectedChannels, selectedChats.

Summary

Method Path
POST /connect/integrations/connect-session
GET /connect/integrations/connections?providerConfigKey=microsoft-teams
GET /connect/integrations/teams/channels
GET /connect/integrations/teams/chats
POST /sync/enqueue

Next Steps