latestOpenAPI 3.1.02026-08-223321,1001.6 MB

2134ebffd1ef

integrations-v3

Start Slack Oauth

Begin an org-scoped "Add to Slack" install and return the authorize URL.

The signed-in user's org is stamped onto the OAuth state, so when the Slack callback lands (on the slackbot host) the install is provisioned to that org immediately — no admin link step. The frontend opens the returned authorization_url in a new tab.

The return origin comes from the request body (browsers omit the Origin header on same-origin requests), falling back to the Origin header.

Permissions: integration setup user.

post/v3/integrations/slack/oauth/start

Query parameters

organization_idstring nullable

Request body

return_urlstring nullable

Frontend origin to return the browser to after a successful install (e.g. window.location.origin). Validated against the allowed frontend origins; ignored if it doesn't match. Falls back to the Origin header.

Response

Successful Response

authorization_urlstring required

Slack authorize URL the browser should navigate to (opened in a new tab).