---
title: "Start Installation"
method: POST
path: "/api/v1/slack/installations"
tags: ["Slack"]
---

# Start Installation

`POST /api/v1/slack/installations`

## Request body

- SlackInstallStart
  - `identity_id` string, uuid, required
  - `workspace_id` string, nullable
  - `return_url` string, nullable

## Response `200`

Successful Response

- SlackInstallResponse
  - `authorization_url` string, required
  - `expires_at` string, date-time, required

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

## Changes

- **2026-10-01** `3e0d51f919a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/slack/installations/post.md)

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inkbox/apis/inkbox-api/revisions/6218d79dde9a?raw)