Skip to main content

Microsoft Teams Integration

Connect and manage Microsoft Teams channels, messages, and members through ConstellationAPI.

Overview​

Microsoft Teams integration uses Apideck's Messaging Unified API, providing a consistent interface to Teams' collaboration and messaging features.

Prerequisites​

  • Microsoft Teams account with appropriate permissions
  • Apideck account with Microsoft Teams 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": "microsoft-teams"
  }'

Step 2: Authorize​

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

Common Operations​

List Channels​

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

Send Message​

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"
  }'

Get Channel Members​

curl http://localhost:3007/teams/channels/19:abc123@thread.tacv2/members \
  -H "X-API-KEY: your-internal-key" \
  -H "X-Tenant-Id: my-tenant"

Best Practices​

  1. Channel Selection: Verify channel IDs before sending messages
  2. Message Formatting: Use appropriate formatting for messages
  3. Thread Management: Reply to existing messages when appropriate
  4. Member Management: Manage channel memberships carefully