​

What’s Supported

​

Supported Actions

This connector supports:

• Read Actions, including full historic backfill and incremental read.
• Write Actions.
• Proxy Actions, using the base URL https://slack.com/api.

​

Before You Get Started

To connect Slack with Ampersand, you will need a Slack Developer Account.

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.
• 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 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.

   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.

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

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.

7. Click Save Changes.

​

Create a manifest file like the example.

​

Additional Information

• If your integration has Read Actions, you’ll start getting webhook messages.
• If your integration has Write Actions, you can start making API calls to our Write API.
• If your integration has Proxy Actions, you can start making Proxy API calls.