Team Integrations API

Endpoints for managing team collaboration platform integrations.

Base URL

/api/integrations/channels

Endpoints

List Connections

GET /api/integrations/channels

Response:

{
  "connections": [
    {
      "id": "uuid",
      "channelType": "slack",
      "workspaceName": "My Workspace",
      "channels": [],
      "notifySettings": {},
      "isActive": true,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

---

Initiate Connection

POST /api/integrations/channels/connect/:type

Path Parameters:

Parameter	Type	Values
type	string	slack, discord, teams

Request Body:

{
  "redirectUri": "https://app.tendsocial.com/settings",
  "webhookUrl": "https://..." // Teams only
}

Response:

{
  "authUrl": "https://slack.com/oauth/..." // For OAuth flows
}
// OR
{
  "success": true // For Teams webhook
}

---

OAuth Callback

GET /api/integrations/channels/callback/:type

Handles OAuth redirect from Slack/Discord. Not called directly.

---

List Remote Channels

GET /api/integrations/channels/:id/channels

Returns available channels from the connected workspace.

Response:

{
  "channels": [
    { "id": "C123", "name": "general", "isPrivate": false }
  ]
}

---

Update Settings

PUT /api/integrations/channels/:id/settings

Request Body:

{
  "channels": [],
  "notifySettings": {
    "newComment": { "channelId": "C123", "enabled": true },
    "approvalNeeded": { "channelId": "C456", "enabled": true }
  }
}

---

Delete Connection

DELETE /api/integrations/channels/:id

Response:

{
  "success": true
}