---
title: "Start a Slack installation"
method: POST
path: "/integrations/slack/installations/start"
tags: ["slack"]
---

# Start a Slack installation

`POST /integrations/slack/installations/start`

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.

## Request body

- SlackStartInstall
  - `app_id` string, required — Slack app ID that the installation flow should use.
  - `auth_url` string — Optional override for the authorization URL returned to the client.
  - `extra_scopes` string[] — Additional OAuth scopes to request during installation.
  - `redirect_url` string — Custom redirect URL to use after OAuth completes.

## Response `201`

Created

- SlackStartInstallResponseContent
  - `app_id` string
  - `auth_url` string
  - `scopes` string[]

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)