Sign in
latestOpenAPI 3.1.02026-08-1014497184.0 KB

8b99dca11019

slack

Start a Slack installation

Initiates the installation flow for a Slack integration. This is the first step in a multi-step installation process where user authorization or external service configuration may be required.

post/integrations/slack/installations/start

Request body

app_idstring required

Slack app ID that the installation flow should use.

auth_urlstring

Optional override for the authorization URL returned to the client.

extra_scopesstring[]

Additional OAuth scopes to request during installation.

redirect_urlstring

Custom redirect URL to use after OAuth completes.

Example request

{
  "app_id": "12345678901",
  "auth_url": "https://example.com/auth",
  "extra_scopes": [
    "scope1",
    "scope2"
  ],
  "redirect_url": "https://example.com/redirect"
}

Response

Created

app_idstring
auth_urlstring
scopesstring[]

Example response

{
  "app_id": "app-id",
  "auth_url": "https://slack.com/oauth/v2/authorize?client_id=app-id&scope=channels:read,chat:write",
  "scopes": [
    "channels:read",
    "chat:write"
  ]
}