> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Slack

> Connect Slack to import your workspace members into Path as a channel, then manage status, reconnect, and disconnect.

Connecting Slack lets [Path](/path) import your Slack workspace members as people, grouped into a channel that represents your Slack workspace. Authorize access once, then import with a single click.

<Note>
  **Before you start**

  * A Slack workspace you can authorize.
  * A TalkValue workspace with an active Pro plan or trial. See [Plans and trial](/administration/billing/plans-trial-pro).
  * Workspace **Admin** role. Only admins can connect integrations. See [Members](/administration/workspace/members) if you need access.
</Note>

## Connection model

* **One Slack workspace at a time.** To switch, disconnect the current one and connect another.
* **Admin-only.** Only workspace [Admins](/administration/workspace/roles-and-permissions) can connect, reconnect, or disconnect integrations.
* **Workspace-scoped.** The connection belongs to the TalkValue workspace, not to the Admin who connected it.

### Authorization

The authorization flow hands you off to Slack, asks you to grant TalkValue access, and redirects back. What TalkValue receives:

* **Read access to your workspace members**: the fields TalkValue maps into a person, such as Email, Name, Phone, Job title, and profile photo.
* **Account email**: shown on the integration card so you can confirm which account is connected.

TalkValue cannot post or edit anything in your Slack workspace.

## Connect

<Steps>
  <Step title="Open Settings → Integrations">
    Sign in at [app.trytalkvalue.com](https://app.trytalkvalue.com), open the side panel, and navigate to **Settings → Integrations**. You'll see a card for each supported provider, including Slack.
  </Step>

  <Step title="Click Connect on the Slack card">
    Click the **Connect** button on the Slack card. TalkValue opens an authorization flow that hands off to Slack.
  </Step>

  <Step title="Authorize TalkValue in Slack">
    Sign in to Slack if prompted, then grant TalkValue read access and approve. Slack redirects you back to TalkValue automatically. TalkValue cannot post or edit anything in your Slack workspace.
  </Step>

  <Step title="Confirm the connection">
    Back in **Settings → Integrations**, the Slack card now shows a green **Connected** badge with the connected account email and the connection date. You're ready to import.
  </Step>

  <Step title="Import your Slack workspace into Path">
    Open **Path → Channels** and click **Import Channel**. In the **Import Channel** dialog, pick **Slack** and click **Import**. Path confirms that the import has started, and the new channel appears in your Channels list.
  </Step>
</Steps>

## What syncs

When you import Slack into Path, TalkValue brings in:

* Your **Slack workspace** as a channel. The channel name is the Slack workspace name.
* Your **Slack members** as people, with these fields:

| Slack member  | TalkValue person     |
| ------------- | -------------------- |
| Email         | Email (identity key) |
| Name          | Name                 |
| Phone         | Phone                |
| Title         | Job title            |
| Profile photo | Avatar               |

**Email** is the identity key. For **Name**, TalkValue uses the member's full name; if that is blank, it falls back to the display name, then the username.

Members are matched by email within your workspace, so re-importing updates existing people in place and adds new ones. Nothing is duplicated. TalkValue also groups people into companies automatically by email domain.

TalkValue imports active members who have an email.

## Status states

The Slack card on **Settings → Integrations** is in one of three states:

* **Not connected.** The card shows a **Connect** button. Click it to start the authorization flow.
* **Connected.** A green **Connected** badge appears in the top right, with the Slack account email and connection date underneath. The card has an external link to Slack and a **Disconnect** button.
* **Reconnect required.** An amber **Reconnect required** badge replaces the green one. The card description reads: *"Authentication expired or revoked. Connect a new Slack account above, then remove this entry."* This state appears when Slack invalidates or revokes access.

## Reconnect

When the card shows **Reconnect required**, TalkValue keeps the disconnected entry visible so you can finish the cleanup deliberately. Click **Connect** on the connectable Slack card above the disconnected one, run through the Slack authorization again, then click **Remove** on the disconnected entry once the new connection is in place. Members you already imported stay in your workspace through the disconnect.

## Disconnect

On the connected Slack card, click **Disconnect**. A confirmation dialog opens. Confirm to flip the card to the not-connected state. Already-imported members and channels stay in your workspace; new Slack members won't sync until you reconnect.

## Troubleshooting

### The Slack card shows "Reconnect required"

Authentication expired or was revoked from the Slack side. Connect a new Slack account on the card above, then remove the old entry. See [Reconnect](#reconnect) for the full pattern.

### Some members are missing from the imported channel

Members without an email are not imported, since email is the identity key. Bots, apps, the Slackbot user, and deactivated members are also skipped.

## Related

* [Slack field mapping](/platform/integrations/slack-fields). Exactly how Slack member fields map to TalkValue people.
* [Connect HubSpot](/platform/integrations/hubspot). The other channel-import connection for Path.
* [Channels](/path/manage/channels). Where imported Slack workspaces appear and sync.
* [Import a CSV](/path/import/csv-quickstart). The manual import path.