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

# Set Up Slack Integration

> Learn how to connect Slack to your landing pages in LanderLab and send instant lead notifications to a Slack channel in real time using an incoming webhook.

Connect Slack to your landing pages in LanderLab to get an instant message in your team's Slack channel every time a new lead comes in. Your team sees each lead the moment it is submitted, without leaving Slack or opening your dashboard.

## What is the Slack integration?

The Slack integration uses a Slack **incoming webhook** to post a message to a channel of your choice whenever a lead is collected on your landing page. You create the webhook once inside Slack, copy its URL, and paste it into LanderLab.

It is a great fit for real-time alerts: notify your sales team in a shared channel or send leads to a private channel only your team can see.

## Before you start

You need one thing to connect Slack: an **incoming webhook URL**. You create it through Slack's developer site by making a small Slack app. The steps below walk you through it.

## Step 1: Create a Slack app

<Steps>
  <Step title="Open the Slack apps page">
    Go to [https://api.slack.com/apps](https://api.slack.com/apps) and sign in to your Slack account. Click **Create an App**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-28.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=ab0a885d045f9e0c6c5d5f92c45d5c73" alt="Image" width="1568" height="782" data-path="images/image-28.png" />
    </Frame>
  </Step>

  <Step title="Choose From scratch">
    In the popup, select **From scratch**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-29.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=9a167b7075c0ca90fcb37a4b21a501fb" alt="Image" width="706" height="487" data-path="images/image-29.png" />
    </Frame>
  </Step>

  <Step title="Name your app and pick a workspace">
    Enter an **App Name** (for example, `LanderLab`) and select the **workspace** where you want lead notifications to appear. Click **Create App**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/image-30.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=25d7bc97ded14070aff3a7e61647efa2" alt="Image" width="564" height="607" data-path="images/image-30.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Activate Incoming Webhooks and get your URL

<Steps>
  <Step title="Open Incoming Webhooks">
    In the app settings sidebar, under **Features**, click **Incoming Webhooks**. Toggle **Activate Incoming Webhooks** to **On**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/MaOcKn9x-e0o8fS_/images/turnonwebhooks.png?fit=max&auto=format&n=MaOcKn9x-e0o8fS_&q=85&s=fa914e7d332518b63900e3888ce35686" alt="Turnonwebhooks" width="1568" height="783" data-path="images/turnonwebhooks.png" />
    </Frame>
  </Step>

  <Step title="Add a new webhook">
    Scroll to the bottom of the page and click **Add New Webhook to Workspace**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/h9RQlkuYw4-wACaD/images/addwebhook.png?fit=max&auto=format&n=h9RQlkuYw4-wACaD&q=85&s=ffffaad6ebfa7da30ec82625cfc1c7ca" alt="Addwebhook" width="1565" height="784" data-path="images/addwebhook.png" />
    </Frame>
  </Step>

  <Step title="Choose a channel and allow access">
    Select the **channel** where you want leads posted, then click **Allow**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/h9RQlkuYw4-wACaD/images/allow.png?fit=max&auto=format&n=h9RQlkuYw4-wACaD&q=85&s=5cf756b906f5e3ebc7d93ce5eca179b6" alt="Allow" width="1568" height="782" data-path="images/allow.png" />
    </Frame>
  </Step>

  <Step title="Copy your webhook URL">
    Back on the Incoming Webhooks page, your new webhook appears in the list. Click **Copy** to copy the URL. It looks like this:

    ```text theme={null}
    https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX
    ```

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/ZGQlHd3XuGnez3SP/images/copywebhook.png?fit=max&auto=format&n=ZGQlHd3XuGnez3SP&q=85&s=42d29f80b26c43be64215367957b4cbd" alt="Copywebhook" width="1685" height="782" data-path="images/copywebhook.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Treat your webhook URL like a password. Anyone who has it can post messages to your Slack channel. Never share it publicly.
</Warning>

## Step 3: Connect Slack in LanderLab

With your webhook URL copied, you can connect the integration.

<Steps>
  <Step title="Open your landing page">
    Go to **Landing Pages** and click the **name of the landing page** where you want lead notifications.
  </Step>

  <Step title="Open the Integrations tab">
    Click **Add Integration** to open the integrations panel, then search for **Slack** and select it.
  </Step>

  <Step title="Enter a name and paste your webhook URL">
    Give the integration a **Name** to identify it, then paste the **Webhook URL** you copied from Slack. Click **Continue**.
  </Step>

  <Step title="Choose your message format">
    Pick how each notification is written. **List** formats every lead field automatically and only asks for an intro text, while **Custom** lets you write your own message template. Click **Continue**.
  </Step>

  <Step title="Review and connect">
    Check the destination channel, message format, and intro text. Every lead field is included automatically. If everything looks correct, click **Connect Slack**.
  </Step>
</Steps>

<Note>
  If your landing page has multiple A/B test variants, you will be asked to choose which variant or variants this integration applies to before it is added.
</Note>

## Test the integration

Submit a test lead through your landing page form or quiz, then check your Slack channel. The app should post a message with the lead details within a few seconds.

## Troubleshooting

<AccordionGroup>
  <Accordion title="No messages are arriving in Slack">
    Confirm the webhook URL was pasted correctly with no extra spaces. Also make sure Incoming Webhooks is still toggled **On** in your Slack app settings.
  </Accordion>

  <Accordion title="Messages post to the wrong channel">
    Each webhook URL is tied to the channel you chose when creating it. To post to a different channel, create a new webhook in Slack (Step 2), copy that URL, and update the integration in LanderLab.
  </Accordion>

  <Accordion title="The webhook URL stopped working">
    If the app was reinstalled or its tokens were revoked, the old webhook URL becomes invalid. Generate a new webhook in Slack and paste the new URL into LanderLab.
  </Accordion>
</AccordionGroup>