Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt

Use this file to discover all available pages before exploring further.

This guide covers the full connection lifecycle for Neo in Slack, from the first workspace install through reconnects, claim/setup, and disconnects.

​
Before You Start

You need two kinds of access:
  • Slack workspace installation access so the app can be installed into the workspace.
  • A Neo account. Any authenticated Neo user can start the connection. If you don’t belong to a Neo team yet, Neo auto-creates one for you on install, named after your Slack workspace, with you as admin. If you are already on a Neo team, only that team’s admin can connect or manage the workspace.
Non-admin members of an existing Neo team cannot connect, reconnect, or disconnect Slack. Ask your team admin to complete those actions.

​
Install Neo In Slack

Use the public install link to start the Slack flow:

Install Neo for Slack

Open the Slack OAuth flow and approve Neo for your workspace.
1

Start in Slack

Open the install link and choose the Slack workspace where you want Neo to operate.
2

Approve access

Review the requested permissions and approve the install for the workspace.
3

Return to Neo

After Slack completes OAuth, you are redirected back into Neo to finish the connection flow.

​
Complete Setup In Neo

When you start the connection from Neo’s integrations panel, Neo redirects back with a successful connection state immediately after Slack OAuth, and the workspace appears under Settings → Applications. If you didn’t have a Neo team, Neo creates one for you using your Slack workspace name and adds you as its admin in the same step — no separate setup is required.

​
Setup / Claim Required (Edge Case)

If the Slack app is installed directly from the Slack App Directory without first signing in to Neo, the install can land in a pending setup state until the workspace is tied to a Neo team.
This is the pending_unclaimed lifecycle state in the backend. In practice, it means Slack install succeeded, but the workspace still needs to be claimed by a Neo team admin from inside Neo.
1

Open Neo after the redirect

Neo reopens the Slack integration flow after the OAuth callback.
2

Complete setup as a Neo team admin

A Neo team admin must complete the claim step from the Slack integration flow inside Neo.
3

Confirm the workspace is active

Once claimed, the workspace moves to the active state and Slack becomes usable for team members with access.

​
Reconnect An Existing Workspace

Reconnect is used when the workspace was previously connected but needs renewed credentials or was intentionally disconnected and is being restored. Common reconnect cases:
  • the Slack token was revoked externally
  • the app was reinstalled or its access changed in Slack
  • the workspace was disconnected in Neo and is now being restored by an admin
If you installed Neo before new permissions were added, you may need to reinstall or reconnect the app so the latest scopes and events are applied.

​
Disconnect A Workspace

Disconnecting the Slack workspace from Neo is an admin-only action performed from Neo. When a Neo team admin disconnects the workspace:
  • the workspace remains known to Neo
  • the Slack installation is marked as disconnected_by_user
  • Slack-side reinstalls alone do not automatically restore the connection
This applies specifically to workspaces that were intentionally disconnected inside Neo. A workspace whose token was revoked externally (revoked_external state) is automatically restored on Slack-side reinstall — the Neo team admin only has to reconnect from Neo when the workspace was disconnected from the Neo side.

​
Ownership Rules

Neo enforces a workspace-to-team relationship to avoid ambiguous ownership. Important rules:
  • a Slack workspace can already belong to another Neo team
  • only admins of the current Neo team can manage the connection
  • Neo chooses the team relationship, not just the Slack install state
If you see an error indicating that the Slack workspace is already connected elsewhere, the workspace is already associated with another Neo team and must be resolved there before reuse.

​
Common Setup Scenarios

​
You Installed In Slack But Nothing Looks Connected In Neo

Likely cause: the install completed, but the workspace still needs to be claimed by a Neo team admin. What to do:
  • open Neo
  • go to the Slack integration flow
  • complete setup as a Neo team admin

​
You Are A Non-Admin Member Of An Existing Neo Team

You can use Neo in Slack once your team admin connects the workspace, but you cannot connect, reconnect, or disconnect it yourself. What to do:
  • ask your Neo team admin to complete the connection from Neo settings

​
You Don’t Yet Belong To A Neo Team

You can install Slack yourself. Neo creates a team for you using your Slack workspace name and adds you as admin during the install. You can rename the team or invite others later from Neo’s team settings.

​
The Workspace Was Disconnected Earlier

Neo will not treat a plain Slack reinstall as a full recovery if the workspace was intentionally disconnected in Neo. What to do:
  • reconnect it from Neo as a Neo team admin

​
Next