Skip to main content

Microsoft Teams API

Manage Microsoft Teams channels, messages, and members through the Messaging Unified API.

Base Path​

/teams

Endpoints​

Channels​

GET /teams/channels​

List all channels.

Request:

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

Response:

{
  "success": true,
  "data": {
    "channels": [
      {
        "id": "19:abc123@thread.tacv2",
        "name": "General",
        "description": "General discussion channel",
        "type": "public"
      }
    ],
    "count": 1
  }
}

GET /teams/channels/:channelId​

Get channel details.

POST /teams/channels​

Create a channel.

Request:

curl -X POST http://localhost:3007/teams/channels \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "Project Updates",
    "description": "Channel for project updates",
    "type": "public"
  }'

Messages​

GET /teams/channels/:channelId/messages​

Get channel messages.

POST /teams/channels/:channelId/messages​

Send a message.

Request:

curl -X POST http://localhost:3007/teams/channels/19:abc123@thread.tacv2/messages \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "content": "Hello team! Here is an update.",
    "subject": "Weekly Update"
  }'

Members​

GET /teams/channels/:channelId/members​

Get channel members.

POST /teams/channels/:channelId/members​

Add member to channel.