---
title: "Connect Slack with a customer-provided app"
method: POST
path: "/v1/integrations/slack/connect"
tags: ["integrations"]
---

# Connect Slack with a customer-provided app

`POST /v1/integrations/slack/connect`

Connect a Slack workspace using a customer-created app's bot token and signing secret.

## Request body

- SlackManualConnectBody — Request body for connecting Slack with a customer-provided app (bot token + signing secret).
  - `bot_token` string, required — Slack bot user OAuth token (xoxb-…)
  - `signing_secret` string, required — Slack app signing secret
  - `store_name` string, nullable — Optional ingestion store name
  - `store_config` IntegrationStoreConfig — Store and file configuration chosen when connecting a data source. Applied to the ingestion store when the connector creates it and to every imported file. The defaults (contextualization on, high-quality ingestion) give the best retrieval quality and downstream availability. A pre-existing store keeps its own configuration; only the ingestion mode still applies to newly imported files.
    - `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.

## Response `200`

The connected Slack installation

- IntegrationInstallationResponse — Integration installation response.
  - `data` IntegrationInstallation, required — Service-level representation of an installed provider integration.
    - `id` string, required — The integration installation ID
    - `created_at` string, date-time, required — The creation time
    - `updated_at` string, date-time, required — The last update time
    - `organization_id` string, required — The organization ID
    - `provider` string, required — The integration provider identifier
    - `external_account_id` string, required — The provider workspace/account ID
    - `external_account_name` string, nullable, required — The provider workspace/account name
    - `installed_by_user_id` string, nullable, required — The Mixedbread user who installed the provider
    - `status` string, required — The installation status
    - `scopes` string[], nullable, required — Granted provider scopes
    - `metadata` object, required — Provider-specific metadata

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/2eece97b5ae5/schema)