Knowledgebase and Documents » IT Support

## 📖 Wiki: Snipe-IT to Slack Integration Guide

This guide outlines the step-by-step process to connect **Snipe-IT** asset management with **Slack** using **Incoming Webhooks**. Once configured, asset movements (check-outs, check-ins, license assignments, etc.) will automatically post real-time alerts to your designated Slack channel.

---

## 🛠️ Phase 1: Create a Webhook via Slack API

1.  **Launch the App Wizard:**

    *   Navigate to the [Slack API Apps](https://slack.com) dashboard and sign in.

    *   Click the **Create New App** button in the top-right corner.

2.  **Select App Configuration:**

    *   Choose the **Blank app** option from the dialog box and click **Continue**.

3.  **Configure App Scopes:**

    *   On the *What it can do in Slack?* (Step 2 of 4) screen, click inside the **Add Bot Scopes** field (or the search bar).

    *   Search for **`incoming-webhook`**, select it from the dropdown to add it to your scopes, and click **Continue**.

4.  **Configure App Events:**

    *   On the *What it can respond to in Slack?* (Step 3 of 4) screen, leave all fields blank (**Keep it at 0**), as Snipe-IT only requires one-way outbound notifications. Click **Continue**.

5.  **Finalize App Creation:**

    *   Review the final confirmation step and click **Create** or **Finish**.

    *   On the success modal, click the green **Go to App Settings** button at the bottom right to enter the management dashboard.

6.  **Retrieve the Webhook URL:**

    *   From the left sidebar sidebar, under the *Features* section, click on **Incoming Webhooks**.

    *   Toggle the **Activate Incoming Webhooks** switch to **On**.

    *   Scroll to the bottom of the page and click the **Add New Webhook to Workspace** button.

    *   Select your destination Slack channel (e.g., `#IT-Asset-Ops`) and click **Allow / Authorize**.

    *   Once the page reloads, scroll down to the table and copy the generated **Webhook URL** (starts with `https://slack.com...`).

---

## 🖥️ Phase 2: Configure Snipe-IT Integration

1.  **Navigate to Integration Settings:**

    *   Log into your Snipe-IT dashboard with administrative privileges.

    *   Go to **Admin > Settings > Integrations** from the top or side navigation menu.

2.  **Enter the Parameters:**

    *   **Integration Option:** Select **Slack** from the dropdown menu.

    *   **Slack Endpoint:** Paste the long Webhook URL you copied from the Slack API dashboard.

    *   **Slack Channel:** Type the exact name of the authorized channel, including the hashtag (e.g., `#IT-Asset-Ops`).

    *   **Slack Botname:** Set a custom display name for the bot inside the channel (e.g., `Asset-Bot`).

3.  **Test and Save:**

    *   Before saving, click the **Test Slack integration** button.

    *   Verify your Slack channel received the message: *"Oh hai! It looks like your Slack integration with Snipe-IT is working!"*.

    *   Click the blue **Save** button at the bottom right to apply the changes permanently.

---

## 📌 Important Notes & Security

*   **Security Disclaimer:** The Webhook URL acts like a secret password. Anyone with access to this URL can post unauthorized messages to your channel. Keep it confidential.

*   **Automation:** Once enabled, all successful check-out and check-in actions performed in Snipe-IT will instantly generate rich-text activity logs in your Slack channel for the IT team to review.