users
users

Start Slack identity link from settings

Mint a Sign-in-with-Slack invite URL initiated from settings, without Slack-DM context. The returned URL takes the user through PostHog login (already satisfied here), then to Slack OAuth, then back to our callback which writes the UserIntegration row.

Without body params, falls back to the user's current_team and that team's first Slack Integration — works when there's exactly one linkable workspace. With team_id + slack_team_id, links against the exact pair (what the frontend uses when a picker is shown).

Refuses if the target team has no matching Slack workspace, if the feature flag is off for the workspace, or if the user is already linked to it.

post/api/users/{uuid}/integrations/slack/start/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/users/{uuid}/integrations/slack/start/
  • Auth: HTTP bearer

Path parameters

uuidstring required

Request body

team_idinteger nullable

Optional team/project id to link against; defaults to the user's current team.

slack_team_idstring nullable

Specific Slack workspace id to link against, scoped to the team. Disambiguates when one team has multiple Slack integrations (rare).

Response

install_urlstring required

URL to open in the browser to start the Sign-in-with-Slack flow.

Changes

No recorded changes to this operation across all 1 revision of this API.