---
title: "Authorize Slack integration"
method: GET
path: "/v1/integrations/slack/oauth/authorize"
tags: ["integrations"]
---

# Authorize Slack integration

`GET /v1/integrations/slack/oauth/authorize`

Start Slack OAuth for the current organization.

## Query parameters

- `store_name` string, nullable — Optional ingestion store name
- `access_mode` 'bot' | 'user' — Authorize as the current Slack user (default). `bot` installs a workspace bot and is only available from the dashboard; requests authenticated with an API key must use `user`.
- `reference` string, nullable — Opaque value echoed back as `reference` on the return URL, so your app can match the outcome to the user who started the flow
- `metadata_contextualization` boolean — Contextualize chunks with the connector's curated metadata fields
- `file_contextualization` boolean — Generate an LLM context for each chunk situating it within the full document
- `ingestion_mode` 'fast' | 'high_quality' — Strategy for adding a file to a store.

## Other responses

- `307` — Redirect to Slack OAuth
- `422` — The request failed validation, or the credentials it carries were rejected

## Changes

- **2026-09-21** `b12f43c90ba3` — 1 warning
  - added the new `bucket_unavailable_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `422`
- **2026-09-15** `957bf8ec8df8` — 1 warning
  - added the new `store_frozen_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `422`
- **2026-09-10** `adde8ecfa74f` — 1 warning, 3 info
  - removed the optional property `detail` from the response with the `422` status
  - added the required property `code` to the response with the `422` status
  - added the required property `message` to the response with the `422` status
  - added the required property `type` to the response with the `422` status
- **2026-09-08** `ce403656bc18` — 1 info
  - added the new optional `query` request parameter `reference`
- **2026-09-07** `1a6549d3e64d` — 1 breaking
  - for the `query` request parameter `access_mode`, default value was changed from `bot` to `user`

[Full history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/slack/oauth/authorize/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/824e59bfac1e?raw)