> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-cobalt0s-google-contacts.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

## What's Supported

### Supported Actions

This connector supports:

* [Proxy Actions](/proxy-actions), using the base URL `https://slack.com/api`.

### Example integration

To define an integration for Slack, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: slack-integration
    displayName: My Slack Integration
    provider: slack
    proxy:
      enabled: true
```

## Before You Get Started

To connect Slack with Ampersand, you will need [a Slack Developer Account](https://api.slack.com/developer-program/join).

Once your account is created, you'll need to create an app in Slack, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

* Client ID
* Client Secret
* Scopes

You will then use these credentials to connect your application to Ampersand.

### Create a Slack Account

Here's how you can sign up for a Slack account:

* Go to the [Slack Sign Up page](https://api.slack.com/developer-program/join).
* Sign up using your preferred method and verify your email.

### Creating a Slack App

Follow the steps below to create a Slack app and add the Ampersand redirect URL.

1. Log in to your [Slack Developer](https://slack.com/signin) account.

2. Click **Your Apps**.

3. Click the **Create New App** button.

4. In the **Create a Slack App** pop-up window, enter the **App Name** and select the **Development Slack Workspace** where you want to develop your app. Click **Create App**.

5. In the left-hand sidebar, navigate to **OAuth & Permissions**.

6. In the **Redirect URLs** section, click **Add a Redirect URL** and enter the Ampersand redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.

7. Click **Add** and then **Save URLs**.

8. In the **Scopes** section, add the necessary OAuth scopes for your app by clicking on **Add an OAuth Scope** and selecting the required scopes.

   <img src="https://mintcdn.com/ampersand-24eb5c1a-cobalt0s-google-contacts/JnltqwAZBdLtN-0w/images/provider-guides/23f128f-slack1.gif?s=3d2b81cd2f557e5bc6af974c35d5d61a" alt="Slack App Creation" width="1440" height="670" data-path="images/provider-guides/23f128f-slack1.gif" />

   You will find the **Client ID** and **Client Secret** in the **Basic Information** section. Note these credentials, as you will need them to connect your app to Ampersand.

## Add Your Slack App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Slack integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a-cobalt0s-google-contacts/JnltqwAZBdLtN-0w/images/provider-guides/31a6a12-Ampersand.png?fit=max&auto=format&n=JnltqwAZBdLtN-0w&q=85&s=2188d76ad1a7bd2dd5520f0736b942b6" alt="Ampersand Project Selection" width="2244" height="442" data-path="images/provider-guides/31a6a12-Ampersand.png" />

3. Select **Provider Apps**.

4. Select **Slack** from the **Provider** list.

5. Enter the previously obtained **Client ID** in the **Client ID** field and the **Client Secret** in the **Client Secret** field.

6. Enter the scopes set for your application in *Slack*.

   <img src="https://mintcdn.com/ampersand-24eb5c1a-cobalt0s-google-contacts/zeOBE9NvXIiRotbQ/images/provider-guides/88f33d5-slack2.gif?s=51a1c6174e79b5d76c8f381828ea6983" alt="Ampersand Integration" width="766" height="522" data-path="images/provider-guides/88f33d5-slack2.gif" />

7. Click **Save Changes**.

## Using the connector

To start integrating with Slack:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for an API key.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the API key supplied by the customer. Please note that this connector's base URL is `https://slack.com/api`.
