Sign in
integrations

Connect Slack with a customer-provided app

Connect Slack using a customer-created app's bot or user token.

A personal connect creates an installation every time, as the OAuth connect does; a bot connect refreshes the workspace's bot installation when the organization has one. To replace an existing installation's tokens, use POST /v1/integrations/slack/installations/{installation_id}/reconnect instead.

post/v1/integrations/slack/connect

Request body

access_mode'bot' | 'user'

Use a personal user installation (default). bot installs a workspace bot and is only available from the dashboard; requests authenticated with an API key must use user.

bot_tokenstring required

Slack bot user OAuth token (xoxb-…)

user_tokenstring nullable

Slack user OAuth token (xoxp-…)

signing_secretstring required

Slack app signing secret

store_namestring nullable

Ingestion store name. A store that already exists is shared: every data source connected to it ingests into it, except another installation of the same account, which would ingest every item again. Without it, the account's default store, numbered past a store another installation of the account feeds. Rejected with 422 when the connect refreshes an existing installation and names a store other than its own.

new_storeboolean

Ingest into a store created for this connection: the connect fails with 409 when store_name names a store that already exists, and without store_name the default name is numbered past existing stores. Rejected with 422 when the connect refreshes an existing installation, which keeps its store.

Response

The connected Slack installation

Changes