Skip to main content
POST
Slack Bot Install Url

Authorizations

Authorization
string
header
required

API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.

Body

application/json

Optional install options.

return_to lets a caller that isn't the Connect Agents page — onboarding, which installs the bot mid-wizard — get the user back where they started instead of dumping them in the dashboard halfway through. It's signed into the OAuth state rather than passed through Slack, so the callback can trust it, and it's re-validated as a path on the way out.

return_to
string | null

Response

Successful Response

url
string
required