External accounts»
Spacelift lets you connect your external accounts — currently GitHub and Slack — to your Spacelift user. Connecting an account proves you own it, and allows Spacelift to recognize you across tools: notification policies can reach you personally on Slack, and your Git activity can be attributed to you as a Spacelift user.
Each user can connect one account per provider, and each external account can only be connected to a single Spacelift user within the account.
You can manage your connections by hovering over your name in the bottom-left corner and selecting Personal settings, then navigating to External accounts.
What connecting enables»
- Slack: notification policies can mention you or send you direct messages — for example when a run you triggered needs confirmation, or a commit you authored breaks a tracked branch. See the notification policy documentation for examples.
- GitHub: commits and pull requests you author are attributed to your Spacelift user, which policies can act on — for example to notify the commit author about the state of the runs their change triggered.
Connecting your GitHub account»
Info
If your organization uses GitHub as its identity provider, your GitHub account is connected automatically when you sign in — there is nothing to set up on this page.
- On the External accounts page, click Connect on the GitHub card.
- You will be redirected to GitHub to authorize the connection.
- After authorizing, you are redirected back to Spacelift. The GitHub card now shows a green Connected badge along with your GitHub username.
Connecting your Slack account»
Prerequisite
Your organization's Spacelift account must already have the Slack integration configured, and you must authorize with a Slack account that belongs to that same workspace.
- On the External accounts page, click Connect on the Slack card.
- You will be redirected to Slack to authorize the connection.
- After authorizing, you are redirected back to Spacelift. The Slack card now shows a green Connected badge.
Disconnecting an account»
Click Disconnect on the relevant card and confirm. Notifications and attribution that target you through that account stop working once it's disconnected.
Warning
You cannot disconnect the account you use to sign in to Spacelift. For example, if your organization uses GitHub as its identity provider, your GitHub connection is your login credential rather than a linked account, and cannot be removed from this page.
Troubleshooting»
| Message | Cause | Resolution |
|---|---|---|
| This GitHub/Slack account is already linked to another Spacelift user. | The external account is connected to a different user in this Spacelift account. | Disconnect it from the other user first, or contact your administrator. |
| Your organization hasn't connected a Slack workspace yet. | The account-level Slack integration is not set up. | Ask an administrator to configure the Slack integration. |
| This Slack account belongs to a different workspace than the one connected to your organization. | You authorized with a Slack account from another workspace. | Retry and authorize with an account from your organization's workspace. |
| Something went wrong. Please try again. | A transient error occurred during the connection flow. | Retry; if the problem persists, contact support. |