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

# Slack

> Connect your Slack workspace and your personal Slack profile to Pike for previews, notifications, and creating tasks and time entries.

![Slack integration](https://mintcdn.com/adjera/_zU2QHSbB_dPWnWK/images/docs/slack-integration.png?fit=max\&auto=format\&n=_zU2QHSbB_dPWnWK\&q=85\&s=40861affbf3bf03bddf13701adddeb9b)

Slack connects to Pike in **two steps**: first the **workspace** (your Pike organization links to a Slack workspace), then optionally **your personal profile** (your Pike user links to your Slack user). Your Slack account must belong to the **same Slack workspace** that the Pike workspace is connected to.

## Connecting the workspace

Connect the integration from **workspace** settings so Pike can work with your Slack workspace (for example link previews and workspace-wide behaviour).

1. Go to **Workspace settings** -> **Integrations** -> **Slack**
2. Click **Add integration**
3. Complete the steps in the popup to authorise and connect the Slack **workspace**
4. Select which Slack workspace to use with this Pike workspace

You need this connection in place before you can connect your personal Slack profile.

## Connecting your personal Slack profile

After the workspace is connected, link **your** Slack user from **personal** settings. Your Slack profile must be a member of the **same Slack workspace** that is already connected to Pike above.

1. Go to **Settings** -> **Connections**
2. Connect your Slack account and follow the prompts
3. If something fails, confirm the workspace integration is connected under **Workspace settings** -> **Integrations** -> **Slack** and that you are using an account from that same Slack workspace

## Notifications

When your personal Slack profile is connected, you can receive notifications in Slack for activity that involves you. What you get can depend on your notification preferences in Pike, but typically includes:

* **Task assignment** - when you are assigned to a task
* **Project assignment** - when you are added to a project
* **Comment mentions** - when someone @mentions you in a comment
* **Other task and project activity** relevant to you (for example updates on items you follow or participate in)

You can adjust how and where you are notified (including Slack vs email) from your profile and notification settings.

## Syncing and link previews

The Slack integration makes it easy to view Pike tasks and their data directly from Slack.

Links from Pike tasks sent in Slack will expand to show a preview with key properties such as description, status, assignee(s), start and due date, project and phase.
Expanded links will include actions when available so that members can update tasks directly from Slack.

Once the preview is live in Slack, refresh it to pull in the latest data from Pike.

![Slack integration](https://mintcdn.com/adjera/DWCv9Q9Ae2C_TyyV/images/docs/slack-integration-preview.png?fit=max\&auto=format\&n=DWCv9Q9Ae2C_TyyV\&q=85\&s=f995471335fce6771a8a22136386c67e)

## Creating tasks and logging time

Create tasks and log time in Pike directly from Slack with the `/pike` slash command. Type `/pike` in any message box and pick what you want to do:

![Slack slash command](https://mintcdn.com/adjera/hWw_3Kc6nj9jjuLX/images/docs/slack-slash-command.png?fit=max\&auto=format\&n=hWw_3Kc6nj9jjuLX\&q=85\&s=d93d52bb844f3249cf04b19a19246bd9)

* **Create Pike task** - opens the create task modal
* **Log time in Pike** - opens the log time modal, where you log time on one of your Pike tasks
* **/pike task \[title] | time | help** - run a command directly:
  * `/pike task [title]` - opens the create task modal with the title prefilled
  * `/pike time` - opens the log time modal
  * `/pike` or `/pike help` - shows help (only you can see it)

You can also open the same modals from the Slack shortcuts menu, or use **Create Pike task** on a message to create a task prefilled with the message text and a link back to it.

When you submit, Pike posts the new task or time entry in your Pike DM. It is also shared in the conversation picked in **Share in**, which defaults to the one you opened the modal from. Clear **Share in**, or use a private project, to keep it to your DM.

> [!NOTE]
>
> You need to connect your personal Slack profile under **Settings** ->
> **Connections** before using `/pike`. You act as your Pike member, with the
> same permissions as in the web app.

> [!TIP]
>
> Upcoming features: - Update tasks from Slack - Comment thread syncing -
> Project and customer preview - Pike AI agent


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.