Start Slack OAuth (admin)

POST /app/integrations/slack/channels/oauth/start

Creates an OAuth intent and returns { authorizeUrl } for browser redirect. After Slack authorization and channel selection, the channel row is created verified (admin path).

There is no URL POST create for Slack — use this endpoint, then complete the flow in the admin console OAuth callback.

Requires the admin or subscriber role and the integrations feature entitlement.

Request

See API Basics for required headers.

Request body

Sample request

curl -X POST https://api.statusdashboard.com/app/integrations/slack/channels/oauth/start \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{
    "dashboardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "managementEmail": "ops@acme.com",
    "componentIds": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"],
    "locked": true
  }'

Sample response

Status: 200 OK

{
  "authorizeUrl": "https://slack.com/oauth/v2/authorize?client_id=…&state=…"
}

Redirect the user's browser to authorizeUrl. After Slack authorization, complete channel selection in the admin console to finish provisioning.

Error responses