Skip to main content
POST
Connect a Slack workspace

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
code
string
required

Slack OAuth authorization code to exchange.

redirect_uri
string
required

The redirect URI registered with the Slack OAuth app.

authorization_intent
enum<string>
default:connect

Optional only during the backend-first compatibility rollout; omission means guarded new connect. Reauthorization must be explicit and may replace only the exact routed installation captured before OAuth.

Available options:
connect,
reauthorize

Response

Slack workspace connected

team_name
string
required

Connected Slack workspace/team name.

Example:

"Acme Corp"

connected
boolean
required

True when the workspace is connected.

Example:

true

enterprise_id
string | null
required

Slack Enterprise Grid ID, or null for a non-Grid workspace.

Example:

"E12345678"

team_id
string
required

Slack workspace/team ID.

Example:

"T12345678"

installation_generation
string
required

Opaque backend-authoritative generation for safely binding Sofia.

Required string length: 16 - 128
Pattern: ^[A-Za-z0-9_-]+$